Documentation
All documentation

Website monitoring

Install the website script on Shopify

Add the generated DocAccessible tag to Shopify theme.liquid, publish the correct theme, and verify it on the public storefront.

For
Shopify store owners, theme developers, and agency teams
Typical time
10-20 minutes
Copy your website script

Before you start

  • Permission to edit the Online Store theme
  • The generated installation code for the storefront domain
  • A duplicate theme or another current backup before editing Liquid

Procedure

Step by step

  1. Copy the generated installation code

    Open the Shopify domain in DocAccessible and copy its exact tag from Installation.

  2. Open the correct theme code

    In Shopify admin, go to Online Store, then Themes. Use the theme actions menu and choose Edit code for the theme that will serve the public storefront.

  3. Open Layout/theme.liquid

    In the code explorer, open the Layout folder and select theme.liquid. Search for the closing body tag near the end of the file.

  4. Paste once before the closing body tag

    Place the complete DocAccessible tag immediately before </body>. Do not put it inside a product, collection, or section template that renders only on some pages.

  5. Save, preview, and publish the intended theme

    Save the file. If you edited a duplicate theme, preview it first and publish that theme only after confirming the storefront still works normally.

  6. Verify the live storefront source

    Open a public storefront page without the theme preview parameter, view page source, search for data-site-key, then return to DocAccessible and confirm Script connected.

Placement in theme.liquid

The installation belongs at the end of the shared storefront layout. Use the tag from DocAccessible in place of the placeholder example.

Layout/theme.liquid placement
  <script async src="https://docaccessible.com/site/v1.js" data-site-key="YOUR_SITE_KEY"></script>
</body>
</html>

Theme updates and replacements

Shopify theme code belongs to a specific theme. A newly installed or updated theme copy may not include edits made to the previous theme, so add script verification to the store's theme-release checklist.

  • Confirm the tag before publishing a replacement theme.
  • Keep the code in only one global layout to avoid duplicate reports.
  • Recheck page source after a theme migration or domain change.
  • Storefront theme code does not control every Shopify-hosted checkout surface.

Shopify troubleshooting

The most common failure is editing a draft while a different theme remains live. Compare the active theme name, open the normal public storefront, and verify the source outside the theme preview.

Official Shopify reference

Shopify recommends editing theme code only when the required change cannot be made through the theme editor or an approved app, and warns that incompatible custom edits can be lost in an updated theme copy.