Edit a room photo’s alt text and description

Marcus Cole

Marcus Cole

Last updated on Nov 18, 2026

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

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