Documentation
All documentation

Website monitoring

Install the website monitoring script

Choose the right installation method, add the generated script once, and verify that DocAccessible can see it in your public page source.

For
Website administrators, developers, and agency partners
Typical time
10-30 minutes
Open connected websites

Before you start

  • A connected website in DocAccessible
  • The exact installation code copied from that website's Installation tab
  • Permission to publish site-wide code on the connected public domain

Procedure

Step by step

  1. Open the connected website

    In Website monitoring, select the domain you are installing and open Installation. Do not reuse code from another connected website because every domain has a different public site key.

  2. Copy the complete generated tag

    Choose Copy installation code. Keep the script URL, async attribute, and data-site-key exactly as generated.

  3. Choose the global installation point

    Use your CMS's site-wide Footer or Body - end code area, the shared server-rendered layout, or the active theme's supported asset system. Add the tag once, not once per PDF.

  4. Publish the website change

    Save and publish the real production site. Clear application, CMS, host, and CDN caches when they can continue serving older HTML.

  5. Open a public page on the connected domain

    Visit a normal public page that includes the script. This first browser report starts verification and provides the exact page that DocAccessible will fetch.

  6. Confirm source and connection status

    Use View page source and search for your data-site-key. Then return to Installation and wait for Script connected. Only after verification can scheduled checking and approved visitor mappings operate normally.

What the generated code looks like

The example below shows the shape of the tag. YOUR_SITE_KEY is only a placeholder. Always paste the exact code from the connected website so the service origin and key match your workspace record.

Example only - use the code from your Installation tab
<script async src="https://docaccessible.com/site/v1.js" data-site-key="YOUR_SITE_KEY"></script>

Choose your platform

Select the system that produces the public website. If an agency, managed host, or custom theme controls the final HTML, send them the custom-site guide together with the generated tag.

The page-source check that matters

DocAccessible does not treat a browser request alone as proof that you control the domain. Its worker fetches the reported public page and looks for the official script URL with the exact site key in the returned HTML.

  • Use View page source, not only the browser Elements panel.
  • Search for data-site-key and compare the complete value with the Installation tab.
  • Confirm the page URL uses the same connected host and HTTPS origin.
  • Do not install only through a tag manager, useEffect, or another client-only loader.

Content Security Policy

A restrictive Content Security Policy must allow the exact DocAccessible origin shown in your generated tag. Merge the origin into the existing directives; do not replace the website's complete policy with this example.

  • script-src permits the browser to load /site/v1.js.
  • connect-src permits inventory reports and approved viewer requests.
  • img-src permits images in an approved accessible viewer.
CSP directive example
script-src 'self' https://docaccessible.com;
connect-src 'self' https://docaccessible.com;
img-src 'self' data: https://docaccessible.com;

If verification does not complete

Start with the source check because it separates publishing problems from network or policy problems. After each correction, open a fresh public page and return to the Installation tab.

  • Wrong key: remove old or duplicate tags and paste the current connected website's code.
  • Missing from source: move the tag from a client-only component into the CMS global code area or server-rendered layout.
  • Old source: purge page, host, reverse-proxy, and CDN caches, then reload in a private window.
  • Blocked request: inspect the browser console for Content Security Policy, extension, consent, or network errors.
  • Wrong host: install and open a page on the exact connected domain, including the intended www or non-www host.
  • Private page: choose a publicly reachable page without authentication, maintenance mode, or an IP allowlist.

Move or remove the installation safely

Keep only one copy of the script per rendered page. When changing themes or platforms, install and verify the tag in the replacement before removing the old implementation.

Disconnecting the website removes its inventory and viewer mappings. Removing only the script stops new browser discoveries but does not automatically delete workspace records.