Choose images from the property's file library and add them to an existing room's photo gallery.

Uploading a file and adding it to a room are separate actions. **Select Files saves the selected room-photo mappings immediately.** There is no second room Save to confirm that action.

## Before you start

- Select the correct property and identify the room you want to show the photos for.
- You need **Content** permission to change photos. Ask your administrator if **Add photos** is missing or a change is refused.
- Finish and save any pending room-detail changes before opening the picker. Photo actions do not save unsaved capacity, rate-plan or description edits.
- Check the room's existing **Photo Mappings** first. Adding the same file again can create another placement of that photo.

Use the current **Add photos** link in the room editor, not an old bookmark or a link copied from another language profile. The room editor chooses the property's shared photo source for you.

## Open the room's photo picker

1. Open **Admin**, then **Settings - CRS**.
2. Select **Rooms & Rates**.
3. Under **Room Types**, select the room's name.
4. On **Room Type Edit**, find **Photo Mappings** and check the existing thumbnails.
5. Click **Add photos**.
6. On **Add Photo Mappings**, check the room name above the file browser and in the breadcrumb.

The name on the picker can be the room's content name, rather than the shorter underlying room name shown in the room list. Check that you entered from the intended room.

## Find and select the images

1. Browse the property's folders or type part of the filename into **Search**. The file list updates to matching files.
2. Select the image files you want to add. Folders are not room photos.
3. Check the highlighted files and the selected-item count. The toolbar changes when files are selected; **Download** and **Rename** can appear in place of the ordinary browsing controls.
4. Click **Select Files** only when the selection is correct. This submits the mappings and returns to the room's **Photo Mappings** section.

![Add Photo Mappings showing a room name, filename search, four matching photos, one highlighted selection, Select Files and Cancel](https://support.channelrush.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ2dDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5ed0e9db5ada235181ebe0cd970cebf799e98803/content-room-type-asset-new-picker.png)

*Demo picker filtered by “studio,” with one file selected but not submitted. The example illustrates the controls, not a recommendation to add an already mapped photo again.*

A **Mapped ×…** badge counts uses of that file across the property's photo mappings. It does not identify this room, prove the file is already in this room's gallery, or mean it has reached a booking channel. Check the room's own gallery before adding it.

To abandon the pending selection, click **Cancel**. It returns to the room editor without adding the selected mappings. It does not undo file uploads, renames or other file-library changes already completed in the picker.

## If the file has not been uploaded

Clear the current selection if necessary to return to the browsing toolbar, then use **Upload**. Choose the intended image files and wait for the uploader's result. An upload changes the property's shared file library immediately; it is not held until **Select Files**.

After a successful upload, find and select the new files, then use **Select Files** to add them to this room. Upload success alone does not put an image in the room gallery.

- Supported upload extensions are `.jpg`, `.jpeg`, `.png`, `.gif`, `.webp`, `.avif`, `.svg`, `.ico`, `.tif` and `.tiff`, with a **50 MB per-file limit**. For room photography, use an appropriate photographic image rather than a logo or icon.
- If the same filename already exists, **Replace** changes the existing file and can affect every placement that uses it. Do not replace an image merely to add it to another room. **Keep both** retains a separate file; check the resulting filename before selecting it.
- Upload errors do not establish that all files in a batch failed. Inspect the library and the individual upload results before trying again.

For detailed file-library operations and replacement precautions, see [Manage property photo files](https://help.channelrush.com/hc/channelrush/articles/photo-file-manager).

## Check the result

1. Look for the save confirmation when you return to **Room Type Edit**.
2. Under **Photo Mappings**, check that the intended images appear and that the count is consistent with what you added.
3. Reopen the room and confirm the mappings remain before repeating **Select Files** after an uncertain result.
4. Check the relevant guest-facing room gallery separately. A saved mapping is not confirmation that every website or booking channel is displaying the image.

Saving photo mappings also synchronizes the property's photo lists, ordering and channel mappings across its content profiles. This synchronization is broader than the one room you edited. It does not translate or copy photo alt text and descriptions between profiles, and it is not a channel-delivery receipt. Optimized guest-facing images are processed separately; the local thumbnail alone does not prove that processing is complete.

The picker does not set gallery order, main-photo choice, alt text or descriptions. Back in **Photo Mappings**, use the ordering controls and **Save order** for order changes, or a photo's **Edit** link for its text. The main room **Save** does not save a pending photo order. See the related guides for those separate tasks.

**If an error appears after submission, inspect the gallery before retrying.** Mappings can save before a later synchronization step fails. Repeating the selection can add duplicates rather than repair the error. If the outcome is unclear, stop and contact support.

## Field and control reference

| Control | What it does |
| --- | --- |
| Room heading and breadcrumb | Identify the destination room. The room breadcrumb returns to its editor. |
| Folder tree and file-browser breadcrumb | Navigate the property's shared file library. The folder name can be the property ID, not a room name. |
| **Search** | Finds matching files from the current file-browser location. Clear the search to return to ordinary browsing. It does not change existing room mappings. |
| Photo tiles and selection count | Show the files selected for the next **Select Files** submission. Selection itself does not create mappings. Review the count before submitting. |
| **Mapped ×…** | Indicates existing uses across the property's mappings, not which room uses the image. |
| **Select Files** | Saves a new mapping for each accepted selected file and returns to the room editor. It does not prevent repeated mappings of the same file. |
| **Upload** | Adds files to the shared library independently of room mapping. Existing filenames require a replacement or separate-copy decision. |
| **New folder** | Creates a library folder; it does not create a room gallery or mapping. |
| **Download** | Downloads selected files; it does not add them to the room. |
| **Rename** | Changes the shared file's name, not the room-photo caption. Existing mappings are maintained by the file-management workflow. This is a separate change, not a pending selection. |
| **Sort by** | Changes the file-browser listing order, not the room gallery's saved order. |
| **Refresh** | Reloads the file listing. It is not a channel-send command. |
| **View** | Changes the file-browser presentation. It does not preview the room's complete guest-facing gallery. |
| **Details** | Shows information about the current file-browser item or location. It does not confirm channel delivery. |
| **Cancel** | Leaves without submitting the current selection. Already completed file-library operations remain saved. |

Right-click menus can also expose **Open**, **Cut**, **Copy** and folder **Paste**. File moves and copies are library operations, not room assignments; use them only when you intend to reorganize the shared files. Do not drag files between folders as a way to add them to this room. The picker has no **Delete** command; use the separate file-management workflow when deletion is genuinely intended.

## Common problems

- **“No files selected, no mappings have been saved....”** No usable file was selected. Select image files rather than only a folder, check the selection count, and submit once. If files appear selected but the error repeats, contact support with the filenames and error text.
- **Add photos or the photo section is missing.** Check the property, room and your Content permission. If the room has no content/photo setup, ask your administrator or support to check it; do not invent an editor URL or create duplicate rooms.
- **“Photos can't be changed in the demo.”** Demonstration accounts allow observation but refuse file changes. A visible picker is not permission to upload or rename files.
- **“You do not have permission to change photos.”** Ask your administrator to check Content permission. Reopening the picker does not change access.
- **The library or expected file is missing.** Check the selected property, folder and Search text. Clear the search and use Refresh. If the library still cannot load, retain the error and ask support before uploading duplicates.
- **A saved photo is missing, duplicated or the result is uncertain.** Reopen the room's Photo Mappings first. Do not repeatedly select the same files or delete mappings as a repair attempt. Contact support if the saved state is unclear.
- **A website still shows the old image.** Check the local mapping and the actual guest-facing room separately. Give support the property, room, filename, affected website or channel, action time and time zone, and any error. Do not send passwords or guest details.

## Related

- [Configure a CRS room type](https://help.channelrush.com/hc/channelrush/articles/crs-room-type-edit)
- [Edit a room photo's alt text and description](https://help.channelrush.com/hc/channelrush/articles/content-room-type-asset-edit)
- [Manage property photo files](https://help.channelrush.com/hc/channelrush/articles/photo-file-manager)