Install and Integrations

Savoy finds the PDF links on your website and gives each one an accessible HTML version. Most sites are set up in a few minutes with one line of code or the WordPress plugin. This page covers the options.

WordPress plugin

If your site runs on WordPress, install the Savoy Accessible plugin. It finds the PDFs in your posts, pages, widgets and media library, converts them, and rewrites the links to point at the accessible versions. Nothing to paste.

In WordPress, go to Plugins, then Add New, and search for Savoy Accessible.
Install and activate it.
Open the Savoy settings, paste your API key from your Savoy dashboard, and save.
Click Scan Now. New PDFs you add later are picked up automatically.

Script tag (any website)

On any other site, add this one line before the closing </body> tag on your pages. Your dashboard shows the exact line with your own site ID filled in.

<script src="https://savoy.chat/widget.js" data-site="YOUR_SITE_ID"></script>

The script looks for links to PDF files on the page and adds an accessible version of each. Your visitors do not need to install anything.

JavaScript only (no script tag)

Some platforms strip out <script> tags but let you add JavaScript in a custom JavaScript box, a tag manager, or your site's own scripts file. In that case paste this instead. It does the same thing as the script tag.

(function () {
  var s = document.createElement('script');
  s.src = 'https://savoy.chat/widget.js';
  s.async = true;
  s.setAttribute('data-site', 'YOUR_SITE_ID');
  document.body.appendChild(s);
})();

Replace YOUR_SITE_ID with the site ID from your dashboard. It needs to run on every page that links to PDFs.

Where to paste it

The line is the same everywhere. What differs is where your platform lets you put it. Look for a setting called header code, footer code, custom code, code injection or scripts. If you cannot find one, your web provider can add it for you, and we can write the request for them.

Where to add the Savoy script on common platforms
Platform	Where it goes
WordPress	Use the plugin above. Or paste the script in your theme footer or a header and footer plugin.
Squarespace	Settings, Advanced, Code Injection (needs a plan that allows code injection).
Wix	Settings, Custom Code, add to the body end on all pages (needs a paid plan).
Shopify	Online Store, Themes, Edit code, then add it to `theme.liquid` before `</body>`.
Drupal	A custom block (Full HTML) in the footer region, or your theme template.
Finalsite	Composer, Themes, External Assets.
GoDaddy Website Builder	Custom code is generally not allowed on this builder. Ask GoDaddy support for an exception, or see "If you cannot add code" below.
Apptegy, CivicPlus, Revize, SmartSites, CMS4Schools, Granicus, Foxbright	These are managed by the vendor. Look for a header code, custom code or external scripts setting. If your account does not have one, use the message under "Ask your web provider" below and they can add it for you.
Google Tag Manager	A Custom HTML tag that fires on all pages.
Other CMS or custom site	Any footer, template or custom code field that outputs HTML on every page.

Some hosted builders do not allow custom code at all. In that case, ask your provider to add it, or contact us and we will help find a route.

Ask your web provider to add it

If you cannot edit your site's code yourself, send this to whoever manages your website. Replace YOUR_SITE_ID with the site ID from your Savoy dashboard.

Hello,

We are adding an accessibility service called Savoy to our website. Please add the following line to every page, in the footer or just before the closing body tag:

<script src="https://savoy.chat/widget.js" data-site="YOUR_SITE_ID"></script>

If our site uses a Content Security Policy, please allow scripts and network requests to savoy.chat.

If custom scripts cannot be added on our current plan, please let us know what our options are.

Thank you.

If you cannot add code to your site

You can still use Savoy without the plugin or the script. These two options work from your Savoy dashboard alone. The trade-off is that you add each document yourself and place the links on your site yourself.

Accessible documents page

Savoy gives you a public page that lists all of your accessible documents. Link to it from your website, newsletters or social posts.

Sign in to your Savoy dashboard and open the Documents tab.
Under Add PDFs by link, paste the web addresses of your PDFs, one per line, and click Convert these PDFs. You can add up to 25 at a time.
Each document shows Ready after a few minutes. Large or image-heavy files take longer.
Under Your public documents page, click Copy link and add it to your site as a menu item or a "Documents" page. It updates automatically as you add more documents, and visitors can search it.

Direct document links

Every converted document also has its own link, so you can point to a single document.

In the Documents tab, find the document and wait until it shows Ready.
Click Copy link on that row.
Use the link in place of the PDF link on a page, in an agenda or in an announcement, or next to it as an "Accessible version" link. Visitors open the accessible version, and the original PDF is one click away.

Converted documents count toward your plan's monthly allowance, the same as documents found automatically. If your provider blocks both the plugin and the script, and you do not want to manage links, ask them about custom code using the message above, or contact us.

How it works

Detection. Ordinary links to PDF files are found automatically.
Conversion. Each PDF is converted to an accessible HTML page on its first visit or scan. This takes a few minutes for a typical document and longer for very large ones.
The viewer. Visitors see the accessible version alongside the original PDF, and can switch between them.
Your control. You can see every document, its status and its accessible version in your dashboard, and reprocess or remove any of them.

Savoy only works with PDFs that are publicly reachable by link. Documents behind a login are not supported. If you cannot add the script or a plugin, see the options for sites that cannot add code above.

Cookies and local storage

The Savoy script sets no cookies. If you turn on the AI chat feature, it stores two small items in the visitor's browser: a random anonymous session ID so a conversation can continue, and a flag noting that the welcome bubble was dismissed. Both are optional conveniences, and visitors can clear them at any time. With AI chat turned off, the script stores nothing in the visitor's browser.

Troubleshooting

My PDFs are not being detected: Check that the script is on the page that contains the link, not only on the home page. Open the page source and search for widget.js. If you use a caching plugin or a content delivery network, clear its cache after adding the script.
The script is blocked: If your site sets a Content Security Policy, it must allow scripts from savoy.chat. Your web provider can add this. Privacy browser extensions can also block it for individual visitors.
A document says it is processing for a long time: Large or image-heavy PDFs take longer. If one stays stuck, use Reprocess on that document in your dashboard, or contact us.
I want to leave certain PDFs out: Tell us which ones. Selecting which documents to convert is something we are building, and your feedback helps us shape it.

Need a hand?

If you are stuck or your platform is not listed, send us a message with the address of your website and we will tell you the best way to install Savoy on it. You can also start a free trial and try it on your own documents.