Add visitor preferences to your Shopify storefront.
Use a duplicate theme, install the script once, and verify shopping journeys before publishing. This manual theme integration does not install a Shopify App Store app or modify checkout.
By the ComplyWCAG team · Updated 13 October 2026
Start with a duplicate theme
In Shopify admin, duplicate the theme you intend to edit so you retain a rollback copy. Review Shopify's current code-editing instructions and your permission to edit the theme. Obtain the dashboard snippet for the published storefront domain.
A theme script runs where the theme renders. It does not imply access to Shopify checkout, customer-account pages, embedded third-party apps, or externally hosted payment pages. Evaluate those surfaces separately and use Shopify's supported extension options where appropriate.
Install, preview, and publish
1. Open the theme code editor
From Online Store → Themes, open Edit code on the duplicate theme. Locate layout/theme.liquid and identify the closing body tag.
2. Add the dashboard snippet
Paste the exact site-specific script before the closing body tag. Keep it outside Liquid comments and add only one copy. Use the correct storefront site ID and approved hostname.
3. Preview the storefront
Check homepage, collection, product variants, search, and cart drawer with keyboard and mobile. Preview hosts may differ from your approved domain; a domain mismatch is not proof that the published installation fails.
4. Verify after publication
Publish only after the theme checks pass. Open the public domain, inspect successful delivery, activate the panel, and test the same journeys again. Record the theme version and verification date.
Keep the purchase journey accessible
A visitor control cannot repair an unlabeled variant selector, inaccessible cart drawer, or unclear validation message. Test the original theme and repair the underlying components. Review checkout separately; a working widget on a product page does not validate checkout.
If delivery fails, check the site ID, hostname, consent integration, network errors, and any CSP. When changing themes, reinstall deliberately and remove duplicates. To roll back, remove the snippet or restore your saved theme copy, then verify the published storefront in a fresh session.
Your next step