When and Why to use Manual Install

For most projects, pages will automatically load when imported into Punchlist. There are a few situations, however, where your site may not work right away. 

Your site may be behind a paywall, it may require users to log in, or it may only be accessible through a VPN or on specific IP addresses. If this is the case, or you see that your site is not loading automatically in Punchlist, you will need to manually install our third-party script on your site.

Installing the script is similar to how any other third-party script, like Google Analytics or Intercom, is installed. You’ll copy our script tag and add it to every page you want to use with Punchlist. Typically, the script is placed in the <head> of your document or before the closing <body> tag. 

Our script is deferred until after your site is loaded. This means our script will politely wait for the rest of the page to load before it is downloaded and executed. There will be no performance hit by installing Punchlist on your site like this. 

To install the script on your site, follow these steps:

  1. Go to the project settings page.
  2. Check the box for “Enable manual install.”
  3. Copy the line of script code.
  4. Paste the code into any page you want to use with Punchlist. You can put it either in the <head> of your document, or before the closing <body> tag.
  5. Go back to the project page and verify the script is working as expected.
  6. You’re done! 🙌


Back to Docs