How to open the Accessibility from a link using a custom trigger

Overview

This guide explains how to let visitors open the Pandectes web accessibility dialog from a custom link, menu item, button, or theme element.

This is useful when you want to add a Web Accessibility link to your footer, header, or another visible area of your storefront.

When Enable custom trigger is enabled, the default floating accessibility launcher is hidden. Visitors will open the accessibility dialog only through the custom trigger you configure.

How the custom trigger works

Pandectes listens for the trigger name:

triggerPandectesA11y

You can use it in two ways:

When visitors click the link or element, the web accessibility dialog opens.

Step 1: Enable the custom trigger

First, enable the option inside the Pandectes app.

Go to Settings > Web Accessibility > Widget, open the Trigger section, and enable Enable custom trigger.

After this option is enabled:

• The floating accessibility widget icon is hidden.
• Visitors can open the dialog only from your custom link or element.
• You can use a menu link, inline link, button, or custom HTML element as the trigger.

Step 2: Add the link to your Shopify menu

Now add a menu item to your storefront navigation.

1. Log in to your Shopify admin.
2. Go to Content > Menus.
3. Select the menu where you want to add the link, such as Footer.
4. Click Add menu item.

Step 3: Configure the menu link

When creating the menu item, use the following values:

You can use another label for the Name field if needed.

Click Add, then click Save to update the menu.

Optional: Use a button or custom HTML element

If you add your own button or custom control in the theme, use the same trigger as an element ID.

Example:

<button type="button" id="triggerPandectesA11y">Web Accessibility</button>

Use:

• #triggerPandectesA11y for links
• id="triggerPandectesA11y" for buttons or custom HTML elements

Both methods open the same accessibility dialog.

Step 4: Test the trigger

Open your storefront and click the new menu link or custom button.

The web accessibility dialog should open and allow visitors to:

• Enable accessibility functions
• Enable accessibility profiles
• Change language options

Notes

• When Enable custom trigger is active, the default floating accessibility launcher is hidden.
• Make sure the custom link or button is visible and easy to find.
• Add the trigger to the footer or header if visitors should be able to open accessibility options from any page.
• If the dialog does not open, confirm that the trigger value is typed exactly as triggerPandectesA11y.

Summary

To open the web accessibility dialog from your own link or button, enable Enable custom trigger, then add either a link with #triggerPandectesA11y or an element with id="triggerPandectesA11y". Visitors can then open the accessibility dialog from the control you added.

Updated on: 03/07/2026