How do I customize the accessibility menu?
On this page
Use the Widget page of the Accessibility module to change how the accessibility menu looks, where it shows and which tools it offers. Visitors’ own choices stay in their own browser and do not change your theme.
Before you start
- Turn on the Accessibility module under Rules.
- Turn on the Custos app embed in your theme (theme editor > App embeds) and save. The menu does not show on your storefront without it. See set up the Accessibility module.
Change the menu
- Open Accessibility > Widget. Settings are on the left and a live preview is on the right. On a narrow screen, select Show preview to see the preview.
- Optional: In the preview, set Device to Mobile or Desktop. Set Show to Widget or Button to check the open menu or only the button.
- On the Button tab:
- Under How visitors open the menu, choose Floating button or Link. See “Open the menu from a link instead of the button” below.
- For the floating button, under Button look, pick a Preset colour pair or your own colours, the Icon and the Button size. If you see “Contrast … is too low. Use at least 4.5:1 so the text stays readable.”, choose colours with more contrast.
- Under Button position, set Side of the screen, Button position (bottom, middle or top) and the distance from the side and from the top or bottom in pixels.
- On the Menu tab:
- Under Menu layout, choose the Menu language, the Menu font and the Menu size on phones.
- Under Menu options, turn on or off the options you want:
- Menu size control: visitors switch the menu between normal and large.
- Language picker: visitors choose the menu language.
- Profiles: one tap turns on the tools for motor, vision, colour, cognitive and other needs.
- Move or hide the button: visitors move the button to the other side or hide it. Alt + Shift + A opens the menu again.
- Reset button: one button switches every tool off.
- Accessibility statement link: links your statement in the menu footer. Enter the page in Statement address, for example
/pages/accessibility-statementor an address that starts withhttps://. - Report a problem: visitors send you a note about a barrier. The app emails it to you, and you find every note under Visitor reports.
- Skip to content link: keyboard users jump to the main content. The app adds it only when your theme has none.
- On the Tools tab, under Menu tools, choose the tools in each group (Reading support, Visual, Content). Drag a row or use the arrows to change the order.
- On the Display rules tab:
- Under Where the menu shows, choose who sees the menu with Show the menu to visitors from: all countries, only the countries you list, or all countries except the ones you list. Shopify passes the visitor’s country to your theme from their market or address.
- Under Phones, turn on Hide on phones to keep the floating button off small screens. Visitors can still open the menu from a menu item that links to
#accessibility-menu.
- Save your changes with the save bar. Select Discard to drop them.
Open the menu from a link instead of the button
- On the Widget page, on the Button tab set How visitors open the menu to Link, then save. The floating button no longer shows.
- In Shopify admin, open Online Store > Navigation and choose a menu, for example your footer menu.
- Add a menu item, for example named Accessibility, and enter
#accessibility-menuas its link. Save the menu. - Keep the Custos app embed on. It loads the menu that the link opens.
Any link to #accessibility-menu on your store opens the menu, for example a link you add in a rich text block.
Verify it worked
- After step 1, the preview shows your menu. After each change in steps 3 to 6, the preview updates.
- After you save, you see “Widget settings saved”. Reload your storefront to see the new settings.
- If you see “Your widget settings weren’t saved”, try saving again. Check any field that shows an error, for example “Add at least one country.”
Troubleshooting
You see “Add at least one country.” You chose Only the countries below or All countries except the ones below without adding a country. Select Add a country, or choose All countries.
You see “Use a page path like /pages/accessibility or an https:// address.” The Statement address has the wrong format. Use a path that starts with / or an address that starts with https://.
The menu link does not open the menu. Check that the Custos app embed is on and that the link is exactly #accessibility-menu.
Good to know
The adjustments are display preferences. They help some visitors, but they do not fix barriers in your theme, such as images without alt text or buttons without a name. The scan finds some of those: see scan your theme and fix issues.
Visitor reports
Open Visitor reports from the Widget page (Accessibility > Widget > Visitor reports) to see what visitors sent with Report a problem.