On this page

Add Snaglist to a website

How-to

Add the 'Send feedback' button to every page of a website with one file and one line. The set-up tool writes this code for you, with your choices. This suits plain HTML sites, WordPress themes, server-rendered apps and anything else that has HTML pages.

Before you begin

Steps

  1. Download snaglist.js from the Snaglist repository. This command saves it in the current folder:
curl -fsSLO https://raw.githubusercontent.com/TheMightyTRex/snaglist/main/snaglist.js
  1. Put snaglist.js in the folder your site serves files from, next to your other scripts.
  2. Add this line to the shared HTML, immediately before </body>. Put your GitHub repository in place of owner/repo:
<script src="/snaglist.js" data-github="owner/repo" defer></script>
  1. Publish the site and open any page. You will find Send feedback in a corner of the page.
  2. Make a test report: Report a problem with one thing on a page.

Things to note

  • For more settings than the script tag allows, start Snaglist yourself:
<script src="/snaglist.js"></script>
<script>
  Snaglist.start({ app: "My site", version: "1.0.0", send: { github: { repo: "owner/repo" } } });
</script>
  • Snaglist reads nothing until someone selects 'Send feedback', and sends nothing until they choose to.
  • To serve the file from your own server with the right headers, read Host Snaglist on your own server.

If it does not work

Read If Send feedback does not appear.

Find out more

This page on GitHub, where the help is written.