Add or correct the text attached to an existing room-photo mapping, then check that the saved values are retained.

A **photo mapping** is an uploaded image’s placement in a gallery. This editor changes the text for one room-photo mapping. It does not replace the image, change its order or edit the room’s main description.

## Before you start

- Select the correct property in the property selector.
- You need **Content** permission to save photo changes. Ask your administrator if the form is disabled or saving is refused.
- The photo must already be mapped to the intended room. Uploading a file alone does not add it to a room gallery.
- If you are already editing **Room Type Edit**, finish and save those room changes before opening a photo’s **Edit** link. Room details and photo text have separate save controls.

Text belongs to the individual mapping you open. Editing it does not automatically update another room, a property-photo placement of the same file, or the text in another language profile. Photo-list synchronization is not text translation.

## Open the room photo

1. Open **Admin** in the top navigation.
2. Choose **Settings - CRS**.
3. Open **Content - Photos**.
4. Under **Room Types**, select the intended room’s name.
5. Find the photo and click its **Edit** link.
6. On **Edit Photo Mapping**, check the room name in the breadcrumb, the filename at the top of the form and the image preview below it.

If you are already on **Room Type Edit**, you can instead find the photo under **Photo Mappings** and click **Edit** there. The editor is the same, but **Save** and **Cancel** return to the page you came from.

Use the photo’s current **Edit** link rather than an old bookmark. A mapping link identifies a particular property, content profile, room and photo placement.

![Edit Photo Mapping with a room breadcrumb, filename, Alt Text and Description fields, View and Delete links, and Save and Cancel controls](https://support.channelrush.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ2NDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--76063b4abfa573e5706a45fb144c4f4edb6c6569/content-room-type-asset-edit-fields.png)

*An existing demo room-photo mapping with blank text fields. No text was entered or saved for this example.*

## Edit and save the text

Typing does not save your changes. Use **Save** or **Save & Refresh** when you have checked both fields.

1. Enter a concise description of the image in **Alt Text**, such as “King bed beside a large window.”
2. Enter any additional photo description in **Description**, such as “Studio room with a seating area and courtyard view.”
3. Choose how to finish:
   - Click **Save** to save and return to the room’s photos on **Content - Photos**, or to **Photo Mappings** on **Room Type Edit** if you entered from there.
   - Open the arrow beside **Save** and choose **Save & Refresh** to save and reopen this photo editor.

Both text fields are optional. To remove existing text, clear that field and save. Keep both fields concise and exclude guest names, contact details and other private information: websites or content integrations can display them.

Saving also synchronizes the property’s photo lists, ordering and channel mappings across its content profiles. That synchronization is broader than this one room, but it does **not** copy the edited **Alt Text** or **Description** to the other profiles. It is not confirmation that a website or booking channel has received or displayed the text.

To leave without submitting your photo-text edits, click **Cancel**. It returns to the same destination as **Save**, without saving these edits. If an unsaved-changes warning appears, leave only if you intend to discard them.

## Check the result

After saving, look for the save confirmation and check the text itself:

- With **Save & Refresh**, confirm that **Alt Text** and **Description** show the intended values in the reopened editor.
- With **Save**, reopen the same photo’s **Edit** link and check both fields.

The image preview is not a preview of the text. It can look unchanged after a successful text save. **Save & Refresh** reloads the editor; it is not a command to replace the photo or send it to channels.

Where the text appears to guests depends on the website, theme or integration using the photo. Check the relevant guest-facing page separately. A local save does not prove channel delivery or acceptance.

If saving reports an error or the outcome is uncertain, reopen the mapping before repeating the operation. The text may have saved before a later photo-synchronization error. If the values are present but the error remains unexplained, contact support instead of repeatedly saving or deleting the mapping.

## Field and control reference

| Field or control | What it does |
| --- | --- |
| Room breadcrumb | Identifies the room whose photo mapping you opened. Its link returns to that room’s settings. |
| Filename | Identifies the uploaded image attached to this mapping. It is not editable here. |
| **Alt Text** | Optional alternative text describing the image. Content consumers can use it for accessibility or other image text. Describe what is visible rather than repeating the filename. |
| **Description** | Optional additional text for this photo mapping. Its display depends on the website or integration; it is not guaranteed to appear beneath every image. |
| **View** | Opens the original image in a new tab without saving text edits. |
| **View - Optimized** | When shown, opens an optimized image rendition in a new tab. This checks the image, not publication of its text. |
| Image preview | Displays the mapped image beneath the form, not the two text fields. |
| **Save** | Saves the text and returns to the room’s photos on the page you entered from. |
| **Save & Refresh** | Saves the same text and reloads this editor. Find it under the arrow beside **Save**. |
| **Cancel** | Returns without submitting the current text edits. It does not undo an earlier save. |
| **Delete** | Opens a separate confirmation page for removing this room-photo mapping. Opening the page does not delete it. |

## If you meant to remove the photo

Do not use **Delete** to clear text. Clear the relevant text field and save instead.

The editor’s **Delete** link opens **Delete Photo Mapping**. Check the room, filename and preview before proceeding. Confirming **Delete** removes the room-photo placement and synchronizes the photo lists across content profiles; it does not delete the uploaded file or a separate property-photo placement of that file. Do not assume every website or channel has already removed the photo.

**Cancel** on the confirmation page returns to the originating room-photo list without deleting the mapping. If a deletion result is uncertain, inspect that list and contact support before repeating it.

For a different image or gallery order, return to **Content - Photos** or the room’s **Photo Mappings** rather than changing the description. File-library changes are separate operations; see the photo-file guide below.

## Common problems

- **The photo is missing from the room’s gallery.** Check the selected property and room. A file can be uploaded without being mapped to that room. If the expected mapping is absent, ask your content administrator or support to investigate before adding duplicates.
- **The form is disabled or refuses a save.** Ask your administrator to check **Content** permission. Demonstration accounts can refuse saves even when fields are visible. Reopening the editor does not remove those restrictions.
- **The editor does not open from an old link.** Return to the current room-photo list and use the photo’s **Edit** link. If that current link also fails, give support the property, room, filename and error; do not delete or recreate mappings as a repair attempt.
- **The preview is missing or View cannot open the image.** Check the filename in **Photo File Manager**. If the file exists but cannot be viewed, contact support before replacing or deleting it.
- **A save returns an error or does not retain the text.** Check any displayed validation message, keep the text concise, and reopen the mapping to establish what actually saved. If the values or error remain unexplained, contact support rather than resubmitting repeatedly.
- **Another placement or language still has different text.** The fields belong to this mapping; synchronization does not translate or copy them. Ask support to confirm the destination’s content profile and mapping instead of repeatedly editing this one.
- **The text is retained here but a website or channel looks unchanged.** Local storage and downstream display are separate checks. Give support the property, room, filename, affected website or channel, action time and time zone, and exact error text if any. Do not send passwords or guest details.

## Related

- [Configure a CRS room type](https://help.channelrush.com/hc/channelrush/articles/crs-room-type-edit)
- [Manage property photo files](https://help.channelrush.com/hc/channelrush/articles/photo-file-manager)