# DocAccessible complete public product documentation
> A consolidated, plain-text rendering of DocAccessible product documentation for retrieval tools and AI agents that need more context than the curated llms.txt index.
Canonical site: https://docaccessible.com
Curated index: https://docaccessible.com/llms.txt
Content review date: 2026-08-21
This file contains public product guidance only. It excludes authenticated workspaces, private documents, customer data, tokens, and API responses. Canonical HTML pages remain the source to cite and share.
## Safety and conformance boundaries
- Automated checking and remediation assist accessibility work; they do not certify conformance.
- Preserve unresolved manual-review findings until a qualified person has evaluated them with representative assistive technology and tasks.
- Rebuilt tagged PDFs may reflow. Use separately scoped specialist remediation when exact pagination, forms, or presentation must remain intact.
- Published alternatives are deliberate, version-bound actions. Discovery or processing alone does not make a document public.
## Documentation index
### Start here
- [Get started with DocAccessible](https://docaccessible.com/docs/getting-started): Set up your workspace, choose the right workflow, and complete your first useful accessibility task.
- [Use the free PDF accessibility checker](https://docaccessible.com/docs/free-pdf-checker): Run a bounded structural inspection, interpret passed, failed, and manual-review findings, and decide the next remediation step.
- [Understand automation, conformance, and manual remediation](https://docaccessible.com/docs/accessibility-boundaries): Know what DocAccessible automates, what still requires human validation, and when exact-layout manual PDF remediation is the right path.
### Documents
- [Upload and remediate a document](https://docaccessible.com/docs/upload-and-remediate): Upload a PDF or DOCX, follow processing, and understand the outputs created by automated remediation.
- [Review findings and edit accessible content](https://docaccessible.com/docs/review-findings-and-edit): Interpret the automated score, resolve structure and alt-text issues, and save a new reviewed version.
- [Publish and share accessible output](https://docaccessible.com/docs/publish-and-share): Choose visibility, publish hosted HTML, and create controlled share links without exposing the private original.
- [Organize documents, folders, activity, and versions](https://docaccessible.com/docs/document-library-and-versions): Use the library to find documents, group work, inspect activity, and understand immutable version history.
- [Monitor processing jobs and retry failures](https://docaccessible.com/docs/processing-jobs-and-retries): Understand queued, running, completed, and failed remediation jobs and retry only when it is safe.
### Website monitoring
- [Connect a website and install PDF monitoring](https://docaccessible.com/docs/website-monitoring-setup): Verify a public domain, install the lightweight script, and begin building a bounded PDF inventory.
- [Install the website monitoring script](https://docaccessible.com/docs/install-website-script): Choose the right installation method, add the generated script once, and verify that DocAccessible can see it in your public page source.
- [Install the website script on WordPress](https://docaccessible.com/docs/install-script-wordpress): Add the DocAccessible script across a WordPress site using a managed code area or a child-theme hook, then clear caches and verify the public HTML.
- [Install the website script on Shopify](https://docaccessible.com/docs/install-script-shopify): Add the generated DocAccessible tag to Shopify theme.liquid, publish the correct theme, and verify it on the public storefront.
- [Install the website script on Webflow](https://docaccessible.com/docs/install-script-webflow): Use Webflow's site-level Footer code, publish to the connected custom domain, and confirm the site key in the live page source.
- [Install the website script on Wix](https://docaccessible.com/docs/install-script-wix): Add DocAccessible through Wix Custom Code on every page, place it at Body - end, and verify the published connected domain.
- [Install the website script on Squarespace](https://docaccessible.com/docs/install-script-squarespace): Add the generated tag through Squarespace Footer code injection, save it site-wide, and verify a public page outside the editor.
- [Install the website script on Drupal or Joomla](https://docaccessible.com/docs/install-script-drupal-joomla): Add DocAccessible through the active CMS theme or asset manager, preserve the site-key attribute, clear caches, and verify rendered source.
- [Install the website script on a custom-built site](https://docaccessible.com/docs/install-script-custom-sites): Add the generated tag to static HTML, shared server templates, React or Vite entry HTML, or a Next.js root layout without breaking verification.
- [Tag managers and client-only script installation](https://docaccessible.com/docs/script-installation-tag-managers): Understand why Google Tag Manager and runtime-only injection cannot complete secure website verification, and move the tag to a supported global template.
- [Review website PDF inventory and source changes](https://docaccessible.com/docs/website-pdf-inventory): Prioritize discovered PDFs, read scan history, handle plan limits, and respond when a public source changes.
- [Convert a discovered PDF and publish an accessible alternative](https://docaccessible.com/docs/publish-website-alternatives): Create a private remediation draft from a public PDF, review it, and explicitly map one completed version for website visitors.
### Exchange
- [Create and manage an Exchange case](https://docaccessible.com/docs/exchange-cases): Set acceptance criteria, invite a scoped vendor, and keep source files, deadlines, and activity in one controlled case.
- [Review, approve, and deliver Exchange work](https://docaccessible.com/docs/exchange-review-and-delivery): Compare immutable revisions, verify evidence, request changes, approve the right submission, and create controlled delivery access.
### Collaboration
- [Request review and approve an exact version](https://docaccessible.com/docs/review-and-approval): Assign a reviewer, track due work, request changes, and bind approval to the version that was actually reviewed.
- [Collect and resolve reader accessibility feedback](https://docaccessible.com/docs/accessibility-feedback): Use hosted-document feedback to reproduce barriers, assign ownership, record resolution, and close the loop with readers.
- [Run an accessibility program hub](https://docaccessible.com/docs/program-hub): Collect client requests, choose a defensible remediation path, coordinate work across workspaces, and record version-bound release evidence.
- [Set up an organization document portal](https://docaccessible.com/docs/organization-portals): Reserve a managed organization hostname, invite your team, configure the public directory, and publish reviewed document versions safely.
### Account and operations
- [Manage workspaces, members, invitations, and roles](https://docaccessible.com/docs/members-workspaces-and-roles): Keep work in the right workspace, invite teammates, assign least-privilege roles, and transfer ownership carefully.
- [Manage account access, security, export, and deletion](https://docaccessible.com/docs/account-security-and-data): Verify account access, recover or change a password, export your documents, and understand permanent account deletion.
- [Use API keys and signed webhooks](https://docaccessible.com/docs/api-keys-and-webhooks): Create scoped integration credentials, verify signed webhook deliveries, and operate integrations without exposing secrets.
- [Understand plans, billing, and usage limits](https://docaccessible.com/docs/plans-billing-and-usage): Read workspace allowances, choose a plan, start checkout, and understand which limits apply to each workflow.
- [Get support and report an accessibility barrier](https://docaccessible.com/docs/contact-support): Send enough context for a useful response without putting confidential documents or sensitive credentials into the contact form.
## Documentation articles
### Get started with DocAccessible
Canonical URL: https://docaccessible.com/docs/getting-started
Set up your workspace, choose the right workflow, and complete your first useful accessibility task.
- Category: Start here
- Audience: New workspace owners and contributors
- Estimated time: 10 minutes
#### Prerequisites
- A verified DocAccessible account
- A PDF or DOCX you are permitted to upload, or a public website you manage
#### Procedure
1. **Confirm the active workspace.** Use the workspace switcher in the app header before creating documents, sites, or Exchange cases. Every record belongs to the active workspace.
2. **Choose the workstream.** Use Documents for automated checking and editable output, Website monitoring for public PDF inventory, or Exchange for vendor-managed remediation.
3. **Start with one real task.** Upload one representative document, connect one verified website, or create one Exchange case. Small first runs make the review and publishing boundaries easier to understand.
4. **Review before publishing.** Treat automated findings and generated output as assistance. Resolve manual-review items and validate important content with people and assistive technology before release.
#### What the dashboard shows
The dashboard brings document usage, website inventory, Exchange capacity, priority findings, recent work, and the next recommended action into one view.
Plan limits are workspace-specific. A visible button does not override an API entitlement or role requirement.
#### Private by default
Uploaded originals and generated drafts remain private until an authorized user explicitly changes visibility or creates a share link. Website discoveries also remain workspace records until a completed version is deliberately mapped for publication.
#### Related documentation
- [Upload and remediate a document](https://docaccessible.com/docs/upload-and-remediate)
- [Connect a website and install PDF monitoring](https://docaccessible.com/docs/website-monitoring-setup)
- [Create and manage an Exchange case](https://docaccessible.com/docs/exchange-cases)
### Upload and remediate a document
Canonical URL: https://docaccessible.com/docs/upload-and-remediate
Upload a PDF or DOCX, follow processing, and understand the outputs created by automated remediation.
- Category: Documents
- Audience: Document owners and remediation contributors
- Estimated time: 5 minutes plus processing
#### Prerequisites
- An active plan with remaining remediation allowance
- A supported PDF or DOCX within the plan file-size limit
#### Procedure
1. **Open Start new work.** From the dashboard, go to the upload area. If you selected a folder first, new documents are placed in that folder.
2. **Select or drop files.** Choose one or more PDF or DOCX files. The browser shows each file's queued, uploading, completed, or failed state.
3. **Wait for a terminal result.** The private original is validated and queued for isolated processing. The document page updates when the job succeeds or fails.
4. **Review the generated version.** Open the document to inspect its score, machine-detectable findings, AI source comparison when available, unresolved manual checks, hosted HTML, rebuilt tagged PDF, and audit report.
#### Outputs and their purpose
Hosted HTML is responsive, editable, and usually the strongest reading experience. The rebuilt tagged PDF is intended for offline use and may reflow or simplify the original layout.
- The original file remains private storage input.
- Each completed run creates an immutable version.
- The audit report records automated evidence, not certification.
#### How AI source comparison works
For eligible PDFs, a constrained structure pass can propose only complete block order or heading and paragraph classification. A separate fidelity pass compares the final blocks with the original PDF and reports content, semantic, and reading-order confidence plus a conservative route.
The confidence values are review signals, not accessibility scores or permission to publish. Provider failure, configured limits, and editor changes leave an explicit manual source-comparison requirement instead of silently reusing confidence.
#### If an upload is rejected
Check the real file type, file size, remaining monthly allowance, and whether the current plan includes automated remediation. A renamed or damaged file can fail content validation even when its extension looks correct.
#### Related documentation
- [Review findings and edit accessible content](https://docaccessible.com/docs/review-findings-and-edit)
- [Monitor processing jobs and retry failures](https://docaccessible.com/docs/processing-jobs-and-retries)
- [Understand plans, billing, and usage limits](https://docaccessible.com/docs/plans-billing-and-usage)
### Review findings and edit accessible content
Canonical URL: https://docaccessible.com/docs/review-findings-and-edit
Interpret the automated score, resolve structure and alt-text issues, and save a new reviewed version.
- Category: Documents
- Audience: Remediation contributors and accessibility reviewers
- Estimated time: Varies by document
#### Prerequisites
- A document with a completed processed version
#### Procedure
1. **Open a completed document.** Select the document from the library and begin with critical and needs-review findings rather than the score alone.
2. **Inspect structure and context.** Check headings, reading sequence, lists, links, tables, image purpose, document language, and any item that software could not responsibly decide. When AI source comparison is available, review its exact concerns and route without treating confidence as conformance.
3. **Open Edit.** Use the findings rail to jump to affected blocks, then correct headings, text, alt text, captions, table structure, lists, callouts, and reading order. Switch to Preview to inspect the unsaved accessible output, draft score, heading outline, and reading sequence before creating a version. AI-generated image descriptions are drafts and need contextual review.
4. **Save and recheck.** Saving creates a new immutable version and reruns applicable deterministic checks. If blocks changed, the prior AI source comparison becomes stale because it was bound to the earlier output. Revisit unresolved manual items before publishing or requesting approval.
#### How to use the score
The score is a prioritization signal based on available automated evidence. It is not proof of WCAG, PDF/UA, ADA, or Section 508 conformance, and it should not be used as the only release gate.
#### Manual review still matters
Reading order, complex tables, charts, forms, language changes, meaningful image descriptions, and the assistive-technology experience can require a qualified person. Keep those decisions visible in your review record.
#### Related documentation
- [Upload and remediate a document](https://docaccessible.com/docs/upload-and-remediate)
- [Request review and approve an exact version](https://docaccessible.com/docs/review-and-approval)
- [Understand automation, conformance, and manual remediation](https://docaccessible.com/docs/accessibility-boundaries)
### Publish and share accessible output
Canonical URL: https://docaccessible.com/docs/publish-and-share
Choose visibility, publish hosted HTML, and create controlled share links without exposing the private original.
- Category: Documents
- Audience: Document owners and publishers
- Estimated time: 5 minutes
#### Prerequisites
- A completed document version that has been reviewed for release
#### Procedure
1. **Choose the delivery format.** Use hosted HTML for responsive online reading. Use the rebuilt tagged PDF when an offline file is required and layout changes are acceptable.
2. **Set document visibility.** Keep the canonical hosted page private, make it unlisted, or publish it publicly. A separate viewing link can provide revocable access to a private document without changing that visibility.
3. **Create a viewing link when needed.** Create a view-only link for someone outside the workspace, choose an expiry, and add a password on eligible plans. Viewing links never grant editing access; invite an authenticated workspace member when collaboration is required.
4. **Test the reader experience.** Open the published URL in a private browser window and check keyboard navigation, headings, links, zoom, mobile reflow, and representative assistive technology.
#### Publication and versions
A later edit creates a new version. Existing review decisions remain bound to the version that was reviewed, so confirm the current version before release.
#### Revoke access
Revoke a viewing link when that recipient no longer needs access. The token, protected document view, and token-bound file downloads stop working immediately. Separately return the canonical page to private when public or unlisted access should also end.
#### Related documentation
- [Request review and approve an exact version](https://docaccessible.com/docs/review-and-approval)
- [Organize documents, folders, activity, and versions](https://docaccessible.com/docs/document-library-and-versions)
- [Collect and resolve reader accessibility feedback](https://docaccessible.com/docs/accessibility-feedback)
### Organize documents, folders, activity, and versions
Canonical URL: https://docaccessible.com/docs/document-library-and-versions
Use the library to find documents, group work, inspect activity, and understand immutable version history.
- Category: Documents
- Audience: All workspace users
- Estimated time: 5 minutes
#### Prerequisites
- At least one uploaded document for version and activity examples
#### Procedure
1. **Filter the library.** Search by title, slug, or visibility. Use All documents, Uncategorized, or a named folder to narrow the list.
2. **Create folders.** Add a folder for a department, release, owner, or campaign. Deleting a folder does not delete its documents; they become uncategorized.
3. **Move a document.** Open the document and use its folder control to place it in another collection without changing the document URL or version.
4. **Review activity and versions.** Use the activity timeline for meaningful lifecycle events and version history for immutable output snapshots and scores.
#### Version rules
Edits and new remediation outputs create versions rather than overwriting review evidence. Approval, website publication, and other release decisions must refer to the exact intended version.
#### Related documentation
- [Review findings and edit accessible content](https://docaccessible.com/docs/review-findings-and-edit)
- [Request review and approve an exact version](https://docaccessible.com/docs/review-and-approval)
- [Monitor processing jobs and retry failures](https://docaccessible.com/docs/processing-jobs-and-retries)
### Request review and approve an exact version
Canonical URL: https://docaccessible.com/docs/review-and-approval
Assign a reviewer, track due work, request changes, and bind approval to the version that was actually reviewed.
- Category: Collaboration
- Audience: Owners, admins, contributors, and assigned reviewers
- Estimated time: 5 minutes to set up
#### Prerequisites
- A completed document version
- A plan and workspace role that permit review workflows
#### Procedure
1. **Open the document review panel.** From a completed document, create a review for the current version and choose an eligible workspace member.
2. **Add context and a due date.** Describe the release decision the reviewer is making and add a realistic due date when timing matters.
3. **Review the exact version.** The reviewer checks findings, content, output, and required manual evidence before approving or requesting changes.
4. **Treat superseded reviews correctly.** If a newer version is created, the earlier approval does not transfer. Start or complete a review for the new version.
#### Use the review queue
The Reviews page separates work assigned to you from requests you created. Status, due date, reviewer, version, and superseded state remain visible for follow-up.
#### What approval means
Approval records a workspace decision about an exact version. It does not certify accessibility and does not replace the manual validation required by the document's purpose and risk.
#### Related documentation
- [Review findings and edit accessible content](https://docaccessible.com/docs/review-findings-and-edit)
- [Publish and share accessible output](https://docaccessible.com/docs/publish-and-share)
- [Manage workspaces, members, invitations, and roles](https://docaccessible.com/docs/members-workspaces-and-roles)
### Monitor processing jobs and retry failures
Canonical URL: https://docaccessible.com/docs/processing-jobs-and-retries
Understand queued, running, completed, and failed remediation jobs and retry only when it is safe.
- Category: Documents
- Audience: Document owners and operators
- Estimated time: 3 minutes
#### Prerequisites
- At least one uploaded document
#### Procedure
1. **Open Processing jobs.** Use the app's More menu or a failed document's View history link to inspect recent work.
2. **Read the terminal state.** Queued and running jobs should progress automatically. Succeeded jobs have version outputs. Failed jobs display sanitized, user-safe context.
3. **Retry once after a transient failure.** Use Retry when the UI offers it. The system creates a new processing attempt without pretending the failed attempt succeeded.
4. **Escalate repeated failures.** If the same file fails again, contact support with the document title, approximate time, and visible error. Do not email confidential source files.
#### Common causes
Damaged files, unsupported structures, malware-scan failures, parser limits, provider failures, or worker resource limits can stop processing. Raw system errors and document content are intentionally not exposed in the browser.
#### Related documentation
- [Upload and remediate a document](https://docaccessible.com/docs/upload-and-remediate)
- [Get support and report an accessibility barrier](https://docaccessible.com/docs/contact-support)
- [Understand automation, conformance, and manual remediation](https://docaccessible.com/docs/accessibility-boundaries)
### Connect a website and install PDF monitoring
Canonical URL: https://docaccessible.com/docs/website-monitoring-setup
Verify a public domain, install the lightweight script, and begin building a bounded PDF inventory.
- Category: Website monitoring
- Audience: Website owners and workspace admins
- Estimated time: 10-20 minutes
#### Prerequisites
- Control of a public website
- Permission to add one script tag to the site's pages or template
#### Procedure
1. **Connect the public domain.** Enter the website origin in Website monitoring. The entered host becomes the crawl origin and consumes the applicable domain allowance.
2. **Copy the generated script tag.** Open the connected website, copy its exact installation code, then use the platform-specific guide to add it once to the global footer or shared server-rendered template.
3. **Load a page on the connected domain.** The first same-domain report starts verification. The server fetches that page and confirms the matching key is present on the script tag.
4. **Confirm verification and inventory.** Return to the site dashboard. After verification, discoveries and bounded scans appear asynchronously as visitors or scheduled checks encounter PDF links.
#### What the script observes
The script reports normalized PDF URLs and the same-domain page where each link appears. It does not collect visitor identity, cookies, form values, or page content.
#### Verification requirements
A browser Origin header is not ownership proof. The public page must load the matching script key, and outbound fetching stays inside the connected domain and its allowed subdomains.
#### Choose your website platform
Use the guide that matches the system responsible for the final public HTML. Every route ends with the same check: open a public page, view its source, and confirm the exact generated site key is present before waiting for verification.
- [WordPress](https://docaccessible.com/docs/install-script-wordpress): Use a site-wide code tool or a child-theme hook without editing the parent theme.
- [Shopify](https://docaccessible.com/docs/install-script-shopify): Add the generated tag to theme.liquid and keep the change with the active theme.
- [Webflow](https://docaccessible.com/docs/install-script-webflow): Use site-level Footer code, publish the site, and verify the custom domain.
- [Wix](https://docaccessible.com/docs/install-script-wix): Add custom code to every page at Body - end and confirm it survives publication.
- [Squarespace](https://docaccessible.com/docs/install-script-squarespace): Use site-wide Footer code injection on an eligible plan.
- [Drupal or Joomla](https://docaccessible.com/docs/install-script-drupal-joomla): Install through the active theme or the CMS asset manager and clear caches.
- [Custom HTML, React, Next.js, and server frameworks](https://docaccessible.com/docs/install-script-custom-sites): Place the script in the shared server-rendered layout so it appears in page source.
- [Google Tag Manager and client-only injection](https://docaccessible.com/docs/script-installation-tag-managers): Understand why runtime-only tags cannot complete verification and choose a supported route.
#### Related documentation
- [Install the website monitoring script](https://docaccessible.com/docs/install-website-script)
- [Review website PDF inventory and source changes](https://docaccessible.com/docs/website-pdf-inventory)
- [Convert a discovered PDF and publish an accessible alternative](https://docaccessible.com/docs/publish-website-alternatives)
### Install the website monitoring script
Canonical URL: https://docaccessible.com/docs/install-website-script
Choose the right installation method, add the generated script once, and verify that DocAccessible can see it in your public page source.
- Category: Website monitoring
- Audience: Website administrators, developers, and agency partners
- Estimated time: 10-30 minutes
#### Prerequisites
- 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
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**
~~~text
~~~
#### 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.
- [WordPress](https://docaccessible.com/docs/install-script-wordpress): Use a site-wide code tool or a child-theme hook without editing the parent theme.
- [Shopify](https://docaccessible.com/docs/install-script-shopify): Add the generated tag to theme.liquid and keep the change with the active theme.
- [Webflow](https://docaccessible.com/docs/install-script-webflow): Use site-level Footer code, publish the site, and verify the custom domain.
- [Wix](https://docaccessible.com/docs/install-script-wix): Add custom code to every page at Body - end and confirm it survives publication.
- [Squarespace](https://docaccessible.com/docs/install-script-squarespace): Use site-wide Footer code injection on an eligible plan.
- [Drupal or Joomla](https://docaccessible.com/docs/install-script-drupal-joomla): Install through the active theme or the CMS asset manager and clear caches.
- [Custom HTML, React, Next.js, and server frameworks](https://docaccessible.com/docs/install-script-custom-sites): Place the script in the shared server-rendered layout so it appears in page source.
- [Google Tag Manager and client-only injection](https://docaccessible.com/docs/script-installation-tag-managers): Understand why runtime-only tags cannot complete verification and choose a supported route.
#### 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**
~~~text
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.
#### Related documentation
- [Connect a website and install PDF monitoring](https://docaccessible.com/docs/website-monitoring-setup)
- [Install the website script on a custom-built site](https://docaccessible.com/docs/install-script-custom-sites)
- [Tag managers and client-only script installation](https://docaccessible.com/docs/script-installation-tag-managers)
### Install the website script on WordPress
Canonical URL: https://docaccessible.com/docs/install-script-wordpress
Add the DocAccessible script across a WordPress site using a managed code area or a child-theme hook, then clear caches and verify the public HTML.
- Category: Website monitoring
- Audience: WordPress administrators, developers, and managed-host teams
- Estimated time: 10-25 minutes
#### Prerequisites
- Administrator or deployment access to the WordPress site
- The generated installation code for this exact domain
- A current backup or staging environment before editing theme code
#### Procedure
1. **Copy the generated installation code.** Open the connected website in DocAccessible, choose Installation, and copy the complete tag. Keep the site key unchanged.
2. **Use the site's supported global-code method.** If your managed host or active theme provides a site-wide footer or body-end code area, use that supported tool. Configure it for the public front end and every page.
3. **Use a child theme when code is required.** Ask a WordPress developer to add the tag through a child theme or a small site-owned plugin. Do not edit the parent theme because an update can erase the change.
4. **Publish and clear every cache layer.** Save the change, deploy it, and purge WordPress page caches, optimization plugins, managed-host caches, and the CDN when present.
5. **Check a logged-out public page.** Open a normal page in a private window, use View page source, and search for the exact data-site-key. Admin previews can differ from cached visitor HTML.
6. **Confirm Script connected.** Reload the public page once, then return to the website Installation tab. If verification fails, compare the page-source key before changing anything else.
#### Choose the safest WordPress method
WordPress core does not provide one universal site-wide script field. Managed hosts, commercial themes, and governance plugins expose different labels, so prefer the installation mechanism already approved for that site.
- Best for site admins: an existing site-wide Footer or Body - end code area.
- Best for development teams: a child theme or small site-owned plugin under version control.
- Avoid: editing footer.php or functions.php in the parent theme.
- Avoid: adding a Custom HTML block to one page, because monitoring should cover the shared template.
#### Optional child-theme hook
A developer can add the exact generated tag from the child theme's functions.php. Replace the placeholder tag below with the installation code copied from DocAccessible, then review it through the normal deployment process.
**Child theme functions.php example**
~~~text
function docaccessible_add_site_script() {
?>
. 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**
~~~text