Ghost has a built-in code injection setting that adds code to every page of your site, and that is all the Yaplet widget needs. You paste the Yaplet code into the site footer, save, and the chat button appears on your site. You don't need to edit your theme or install an integration.
Menu names below are written exactly as Ghost's own help shows them. To change these settings, you need to be an Administrator of the Ghost site.
1. Copy your Yaplet code
In the Yaplet dashboard's left menu, click Chat widget under your brand's name and open the Install tab. Under Where does your website run?, choose Other website. Copy the code with the copy button on the code block.
If the code you copied starts with !function (Yaplet, it has no <script> tags around it yet. Ghost needs those tags, so you add them in step 3.
2. Open code injection in Ghost
In Ghost Admin, go to Settings → Advanced → Code Injection. You see two boxes: Site Header and Site Footer.
3. Paste the code into Site Footer
Click into Site Footer and paste the Yaplet code. The code must start with a <script> line and end with a </script> line. If what you copied starts with !function (Yaplet instead, type <script> on a new line before it and </script> on a new line after it. The finished code looks like this:
<script>
(your Yaplet code)
</script>
Ghost adds the Site Footer code at the end of every page, which is where Ghost recommends putting JavaScript.
4. Save
Save your changes. There is no separate publish step: the code is live on your site as soon as it is saved.
5. Check your site
Open your site in a new browser tab and reload the page. The Yaplet chat button appears in the bottom-right corner. Click it to check that the chat opens.
For a full checklist, see Verify your installation.
If the chat doesn't appear
- You can't find Code Injection. In some Ghost versions it sits directly under Settings. If you can't open the settings at all, your Ghost role doesn't allow it: Contributors, Authors and Editors can't change site settings. Ask an Administrator.
- The code shows up as text at the bottom of your pages. The
<script>tags are missing. Add them as shown in step 3 and save again. - The chat shows on one post only. You pasted the code into that post's own code injection, in the post settings. Move it to the site-wide Site Footer.
- You still see the old page. Your browser or your site's cache may show an older copy. Reload the page, or open it in a private window.
What's next
To see what the code does and where your widget ID is, read Install Yaplet.