Add Live Chat to Ghost: Code Injection Guide

To add live chat to Ghost you need one script tag and about five minutes. Ghost has a built-in code injection setting that adds code to every page of your publication without touching the theme, which is exactly what a chat widget needs. This guide walks through the steps, then covers what to check afterwards and how to make the assistant useful for a site built around posts, newsletters and memberships.

The assistant here is Mio, the AI in Talkmio. It reads your public pages, answers visitors from that content in their language, and passes the chat to your team when a person is needed. Everything below applies to self-hosted Ghost and to hosted Ghost sites, as long as your account can edit site-wide code injection.

Before You Add Live Chat to Ghost

Have three things ready:

A Talkmio account. The free plan includes 1 operator, 1 website and 50 AI answers a month, with no card. Create it at app.talkmio.com and confirm your e-mail.
Your site key. In Talkmio, open Websites, add your Ghost site and copy the 12-character site key. It belongs to that website only.
Admin access to Ghost. Code injection lives in Ghost Admin, so you need a role that can open it, normally an Administrator or the Owner.

It also helps to know why Ghost suits this. Ghost is a publishing platform with newsletters and paid memberships, so visitors often have questions before they subscribe: what the paid tier includes, how billing works, how to cancel, and why a newsletter did not arrive. Those questions repeat, and they are what the chat answers best.

Step by Step: Add Live Chat to Ghost With Code Injection

The official Talkmio instructions for Ghost are on the Ghost integration page. In short:

Sign in to Ghost Admin.
Open Settings → Code injection. In some Ghost versions this sits under an Advanced section of the settings; look for the words “Code injection”.
Find the box labelled Site footer.
Paste this line, replacing YOUR_SITE_KEY with the key from Talkmio:

<script src="https://app.talkmio.com/w/YOUR_SITE_KEY.js" async></script>

Click Save.
Open your publication in a private browser window. The chat bubble appears in the corner of every page that loads the footer code.

That is the whole installation. There is no theme edit, no plugin and no build step. Because the code is stored in your Ghost settings rather than in the theme files, it stays in place when you change or update the theme.

Why the footer and not the header

The footer box loads the script at the end of the page, after your content. The script also carries the async attribute, so it does not block rendering. A chat widget does not need to appear before the article text, and keeping it low in the page protects your reading experience and your loading metrics. If you want to understand the speed side in more detail, read our article on the page speed impact of a chat widget.

Per-post code injection is not what you want

Ghost also lets you add code to a single post or page from its settings panel. That is useful for a one-off embed, but it would show the chat only on that post. For a chat that follows the visitor across the site, use the site-wide footer setting described above.

What to Check After You Add Live Chat to Ghost

Do a short test before you tell anyone:

Home page, a post, a tag page and a static page. The bubble should appear on all of them.
Mobile. Open the site on a phone. The bubble should not cover the subscribe button or cookie banner. If it does, change the position in Websites → your site in Talkmio.
Logged-in members. Sign in with a test member account and open a members-only post. The footer code loads there too.
Cache. If you use a caching layer or a content delivery network in front of Ghost, clear it after saving so visitors receive the new footer.
A test conversation. Send two or three questions your readers really ask, and check the answers in the Inbox.

If the bubble does not appear, check three things in order: the script was saved in the footer box, not the header box; the site key has no extra spaces or quotation marks; and your domain matches the website you added in Talkmio. Our documentation lists the standard install checks.

Teach Mio From Your Ghost Content

A chat is only as good as what it knows. In Talkmio, go to Mio AI → Knowledge base and add your website. Mio reads every public page on the same domain and respects robots.txt. For a Ghost publication, that includes posts, pages, tag pages and author pages. Some practical points:

Public content only. Paid or members-only posts are not public pages, so Mio cannot answer from them. That is usually what you want; do not paste paid content into the knowledge base unless you accept that visitors could get it from the chat.
Add what your posts do not say. Create Q&A pairs for subscription tiers, billing dates, refunds, how to change e-mail address, how to unsubscribe and how to reach the newsletter team.
Add files. A media kit, a sponsorship rate card or a style guide can be uploaded as PDF, DOCX, TXT, MD, CSV or HTML, up to 15 MB each.
Re-read after changes. After a pricing change or a new membership tier, use Re-read on the website source. Our guide on keeping chatbot answers current explains a simple routine.

Then write business instructions. Tell Mio what you publish, the tone to use and what it must never promise. For example: “Never confirm that a payment succeeded; hand billing questions to the team. Do not summarise paid posts.” Test with Try Mio, where you can see the answer, the knowledge pieces used and the response time.

Ghost Questions the Chat Can and Cannot Handle

Reader question	Who handles it
What does the paid tier include?	Mio, from your tiers page
How do I unsubscribe from the newsletter?	Mio, from your instructions page
Which post covers a topic?	Mio, from public posts
I was charged twice	Your team, after a handoff
My login link did not arrive	Your team, with checks in Ghost
Can I sponsor your newsletter?	Mio gives rates from your rate card; your team negotiates
I want to cancel and get a refund	Your team

Mio hands the conversation over when it cannot answer from your content, when the visitor asks for a person, complains, or asks about a specific order. The chat then shows a “needs human” badge in your Inbox, you receive a browser notification, and if nobody is online, an e-mail. Billing questions about a specific member belong in that last group, since Mio has no access to your Stripe or Ghost member records.

Small Publications: Staffing and Hours

Most Ghost publications are run by one to five people. You do not need a 24/7 operation. Set business hours in the widget settings, write an offline text that says when you reply, and let Mio handle the common questions at night. When the team is offline, visitors are asked for an e-mail before their first message and your reply later goes out by e-mail.

The Talkmio mobile app for iOS and Android sends push notifications for new messages and handoffs, so a solo publisher can answer a billing question from a phone without sitting at a desk. Use the status switch (Online, Away, Offline) so the widget does not promise a person when you are away.

Troubleshooting a Ghost Chat Widget

Most problems come from a short list of causes. If the bubble is missing, look at the browser console for a blocked script, since some privacy extensions and corporate networks block third-party scripts, and test in a clean private window. If the bubble shows twice, you pasted the line in both the header and the footer box, or an old plugin also injects it; keep one copy. If it appears on the live site but not in a preview, remember that previews may not run site-wide injection. The Ghost help centre describes the settings screens for your version if the menu names differ from the ones above.

Newsletter and Membership Tips

Link the chat to your promise. Write the welcome text around what readers ask most, such as “Questions about plans or your subscription?”
Do not duplicate Portal. Ghost has its own sign-in and account screens. Point readers there for account changes and use the chat to explain how.
Keep personal data out of chat. Tell readers not to send card numbers or passwords. If you collect names or e-mail addresses, set the pre-chat form to optional or required deliberately.
Review the transcripts. Repeated questions tell you what your tiers page or welcome e-mail fails to explain. Our note on plans and pricing shows what each tier includes if you need more operators or AI answers later.

Removing or Moving the Widget

To remove the chat, go back to Settings → Code injection, delete the Talkmio line from the footer and save. To move it to another Ghost site, add that site as a second website in Talkmio, copy its own key and repeat the steps. Pro includes up to three websites. You can also rename the assistant, change its colour and position, and choose a fixed language instead of auto-detect under Websites → your site.

If you later migrate from Ghost to another platform, the same snippet works anywhere that accepts a script before the closing body tag. The WordPress guide covers the plugin route.

Frequently Asked Questions

Where do I paste the chat code in Ghost?

In Ghost Admin, open Settings → Code injection and paste the Talkmio script into the Site footer box, then save. The script loads on every page of the publication. It uses the async attribute, so it does not block the page from rendering, and it survives theme changes because it is stored in your settings.

Do I need a developer to add live chat to Ghost?

No. If you can open Ghost Admin and paste one line into the footer injection box, you can finish the installation yourself. A developer is only useful if you run a custom caching setup or want to hide the widget on specific pages with your own code.

Will the chat appear for logged-in members and on members-only posts?

Yes, the footer code loads on every page the visitor opens. However, Mio only learns from public pages, so it cannot answer from paid posts. Add Q&A pairs about plans and billing, and keep premium content out of the knowledge base unless you are happy for the chat to quote it.

Does Talkmio work with Ghost on a free plan?

Yes. The free Talkmio plan includes 1 operator, 1 website and 50 AI answers a month, and nothing about the Ghost installation changes between plans. Paid plans add operators, websites, more AI answers, the e-mail channel and removal of the Powered by Talkmio line.

Can Mio answer billing questions about a specific member?

Not about an individual account. Mio answers from your content and has no access to your payment or member records. When a visitor asks about a specific order or payment, complains or asks for a person, the chat is handed to your team with a needs-human badge and the full history.

How do I remove the chat from Ghost?

Open Settings → Code injection, delete the Talkmio script line from the Site footer box and save. The bubble disappears from all pages as soon as any cache has cleared. Your Talkmio account, knowledge base and past conversations remain, so you can add the code again later.

The Bottom Line

To add live chat to Ghost, paste one async script into Settings → Code injection → Site footer, save, and test on a few pages and on mobile. The real work is afterwards: let Mio read your public posts, add Q&A pairs for tiers and billing, set clear limits, and keep a person reachable for payments. Create a free Talkmio account, copy your site key and have the chat running on your publication today.

How to Add Live Chat to a Ghost Site