Skip to main content Link Search Menu Expand Document Toggle dark mode Copy Code (external link)
paperwork.help

Troubleshooting

These are problems you may meet when you build a link or an embed. For everyday questions from people using a document, see Paperwork Support.

Add ?pwdebug to the address of the page that holds the viewer, and open the browser console, to see what the viewer is doing.

What your visitors see, and what to tell them

If someone sees a sign-in prompt, a “not available to you” message, missing content or a failed download, those are answered for the people opening the link on Paperwork Support. Send them there, and use this page for problems with how the link or embed is built.

The embedded viewer is empty

  • It starts when it scrolls into view, and the first one on a page can take a few seconds. Wait a moment.
  • Check the script is loaded: https://paperwork.vu/er.js.
  • Each viewer on a page needs its own data-pw-container name.
  • Check the template id is written owner:name, for example richard-prod:invoice-example.

The viewer asks the visitor to sign in

  • A template in a collection needs the visitor to sign in as a member, and the embed needs data-pw-collection.
  • A personal template opens only for the person who published it, signed in.
  • Passing a collection for a public template also asks the visitor to sign in. For a public template, leave the collection out.
  • A field is matched by the id it was given in the Designer. Check the spelling and the case.
  • Join the values with &, and put a ? before the first one.

A message says the current host domain is not supported

The Viewer itself is running at an address that is not a Paperwork portal. This is not about the site that embeds the Viewer: nothing restricts which sites can embed or link a template. Open the Viewer from its normal address, https://paperwork.vu/, or the address your portal gave you.

Part of the document is missing: a picture, a font or data

While a document is made, it fetches data, images, fonts and connector data. The portal has allow and block lists for the addresses it may fetch from. If an address is blocked, that item does not load and the document is made without it.

Check the addresses of the template’s data, image and font sources against the portal’s lists, and ask the portal’s admin to allow the ones you need. See Portals.

Another script uses the name pw

Hand the name back and keep the viewer under one of your own. See Embed with JavaScript.

Still stuck

Ask Paperwork Support, and say the address of the page and what you see.