Skip to content
English
  • There are no suggestions because the search field is empty.

How to Make Your Site Accessible

Work through the four accessibility jobs you control yourself (image descriptions, decorative images, button labels and heading order) so a guest using a screen reader can book a room as easily as anyone else.

Read this first: the platform will not stop you saving a page with none of this done. An image with no description saves without any warning and looks perfect on screen. Nothing points it out until someone audits your site, or until a guest cannot use it.

Step-by-Step Instructions

1. Describe Every Image That Carries Information

A screen reader reads the description aloud in place of the picture. Without one, a guest hears the file name, or nothing at all.

  1. Open Images & Docs, find the picture, click the ▾ on its tile and choose Edit Alt Text.
  2. Say What Is In It, in the words a guest would use: King suite bedroom with harbour view, not IMG_4471 and not hotel photo.
  3. Do It in Batches: Tick several pictures, open Mass Edit and choose Edit Alt Text to get one row per picture on a single screen.

For the full steps, including the punctuation the box rejects and the two places a library description does not reach, see How to Fix Image Alt Text.

2. Clear the Description on Decorative Images

Not every picture carries information. A divider, a background texture or an ornament behind a heading tells a guest nothing they need.

  1. Decide What the Picture Is For: If a guest would lose nothing without it, it is decorative.
  2. Clear the Box Completely: Leave the Alt Text field empty rather than typing decorative, spacer or the file name.
  3. Result: A screen reader skips the picture entirely instead of reading a meaningless label aloud.
    • ⚠️ A description of "divider" or "image" is worse than none. It interrupts the guest with a word that helps nobody, and it counts as a described image in an audit.

3. Label Buttons Whose Text Does Not Say Where They Go

A guest using a screen reader can open a list of every link on the page. In that list, six buttons all reading Learn More are six identical entries.

  1. Open the Widget and click Edit on the button.
  2. Find the ADA Button Text Field: It sits under the button's own text and is optional.
  3. Write Where the Button Goes: For a button that reads Learn More, write Learn more about our spa treatments. A guest looking at the screen still sees Learn More. The screen reader reads out the longer version.
  4. Leave It Empty When the Button Already Says Enough: A button reading Book the Harbour Suite needs nothing added.

4. Keep Your Headings in Order

A guest using a screen reader moves around a page by jumping from heading to heading, much as a sighted guest skims. If the headings are out of order, that stops working.

  1. Use the Heading Type Dropdown, not the text size, to set a heading's level. It is a structural choice.
  2. Give Each Page One H1: The page's main subject. On the homepage this is usually the first hero headline. On a Rooms or Dining page it is the heading at the top of the content.
  3. Go Down in Order: H2 for each main section, H3 for items inside a section. Do not jump from H1 straight to H3.
  4. Never Pick a Level for Its Size: A heading that looks too big is still the right level. Its size is a design matter.

5. Check It, Then Publish

  1. Open Page Preview and read the page from top to bottom.
  2. Ask Whether the Page Still Makes Sense With No Pictures: Wherever a picture carried meaning, its description now has to carry it.
  3. Publish: Nothing you have changed reaches a guest until you do. See How to Publish Your Site.

Pro-Tips & Troubleshooting

  • Where do I start on a site with hundreds of images? Start with the pages guests use most: the homepage, rooms, offers and booking. A description on a picture nobody has placed on a page changes nothing for anybody.
  • I fixed the description in the library and the page has not changed. That placement has its own description set on the widget, or the picture sits inside a block of text. Both are covered in How to Fix Image Alt Text.
  • The box rejected my text. There is an apostrophe or a quotation mark in it. Write the terrace at the hotel rather than the hotel's terrace.
  • My picture is a photograph of text, such as a menu or a poster. Put all the words into the description. A guest who cannot see the picture cannot read the menu.
  • There is no ADA Button Text field on this widget. Then the button's visible text is all a guest gets. Make it say where it goes.
  • Two of my headings are the same level and one is clearly a sub-section. Drop the sub-section to the next level down. Equal levels tell a guest the sections are equal.
  • My hero has a video. Hero video always starts silent, so no message can rely on its sound. Anything the video says has to appear as text on the page as well.

→ Next: How to Fix Image Alt Text — the image descriptions in full, including how to do them in bulk

Related: How to Fill In a Widget — the Heading Type and ADA Button Text fields in place · How to Use the Text Editor — headings inside a block of text · How to Check What Uses an Image — every page a picture appears on