Blogima is a browser extension for Ghost that helps you build and maintain healthy internal links (suggestions, broken-link detection, post health, and more) without leaving your editor.
This guide walks through:
- Installing Blogima from the browser extension store.
- Completing the 5-step onboarding wizard (exactly as you'll see it in the pop-up).
- What happens after setup (indexing/embeddings) and common troubleshooting.
What you'll need (before you click "Install")
- A Ghost website, you are the administrator.
- Your website domain (public, reader-facing)
- Examples:
example.com,blog.example.com
- Examples:
- Your admin website (where you log in to Ghost Admin)
- Examples:
example.com(self-hosted),example.ghost.io(Ghost(Pro))
- Examples:
- A Ghost Content API key (read-only access to your content)
As an example of a Ghost blog, we will use this technical blog at blog.tericcabrel.com.
1- Install Blogima from the web store
Blogima web extension supports the browsers Google Chrome and Firefox. Here are the links for your related browser:
On the Web extension page, click the Install button. Once installed, pin it for easy access and open the extension pop-up.
2- First run: the onboarding wizard (5 steps)
When you open Blogima for the first time, you'll see a step-by-step wizard. The wizard asks for the minimum information Blogima needs to connect to your Ghost site and validate it.
Step 1 - Welcome
You'll see a welcome message and a short explanation that Blogima needs a few details to initialize your account.
Step 2 - Website domain
Enter the domain readers use to reach your blog.
Examples: example.com or blog.example.com
If you see "Invalid domain name", double-check for:
- A pasted URL like
https://example.com/, remove protocol "https://" and trailing slash "/". - Typos or spaces.
Step 3 - Admin website domain
Enter the domain you use to access your Ghost administrator panel.
If you're self-hosting Ghost, the admin domain is usually the same as your website domain.
Step 4 - Ghost Version
Enter the version of Ghost running on your blog.
- If your Admin website domain is valid, click Autofill to prefill it.
- If you prefer to look it up manually, read this guide on how to find the Ghost version.
Version format matters: Blogima expects a major version of 4, 5, or 6, followed by a dot and digits (examples: 5.75, 6.0).
If you see "Invalid version number", check that:
- You included the dot (e.g., "5.75", not "575")
- The major versions are 4, 5, and 6.
Step 5 - Ghost Content API key
The content API key is used to access your content via the Ghost Content API in read-only mode. This API accesses publicly available data, such as
- Published posts, pages, and tags
- Blog settings and tiers.
This key is safe to use in browsers or insecure environments because it doesn't expose any private information.
Read this step-by-step guide about finding your Content API key in the Ghost administrator space.
Once you have your Ghost Content API key, paste it in the input field.
Click Verify. Blogima will validate the API key by fetching the total number of published posts and automatically detecting your blog's language.
If verification fails, you'll see "The content API key is invalid" (see Troubleshooting below).
Finish the setup
The "Complete" button is enabled only after a successful Verify on the final step.
3- After the onboarding completion
After you complete onboarding:
- Your configuration is saved, so you don't have to repeat the setup on future launches.
- Blogima kicks off content indexing, which powers suggestions.
- You'll be taken to Blogima's main pop-up experience that displays your internal link health score.
During indexing, some features (notably link suggestions) may be unavailable until processing finishes. If you see messaging like "Link suggestions are unavailable until indexing is complete.", that's expected right after first setup.
The Pop-up main UI after the onboarding.
You can also see the number of orphan posts and some improvements you can make to improve your Internal Link Health Score. There is a link to view the dashboard. Click on it to see more details about your blog score and also the score per blog post.
4- Permissions & privacy (what Blogima can access)
The Browser extension Blogima runs in your browser and requires only the necessary permissions to provide you with the best experience while building Internal links for your Ghost blog.
Here are the permissions required:
- Access your data for all websites: This is a key permission; it might look scary, but we only need it to retrieve the current browser's URL to check whether it is a Ghost URL for your blog. We don't look for any other information.
- Read and write to browser storage: This is useful for storing your blog settings, your internal link health score, and your auto-linking rules.
Blogima's design is to activate and process data only on website pages that match your configured Ghost domain. When the current page of your browser is not your Ghost blog page, Blogima does nothing.
Troubleshooting / FAQ
Invalid domain name
- Remove `https://` and any path/querystring.
- Remove trailing slashes.
- Ensure it's a plain domain/subdomain like `example.com`.
Autofill doesn't work on "Ghost Version"
Common causes:
- The Admin website domain is mistyped.
- Your Ghost admin isn't reachable from the current browser context (network restrictions). Try entering the version manually and continue.
Invalid version number
Use a format like `5.75` or `6.0`. The major version must be 4, 5, or 6.
The content API key is invalid (verify fails)
Double-check:
- You copied the Content API key (not an Admin key).
- Your Admin website domain is correct.
- Your Ghost version is correct (try manual entry if Autofill was wrong).
Link suggestions are unavailable
This typically means your initial indexing/embeddings are still being generated. Give it a bit of time, then reopen the pop-up.
What to do next
- Add your auto-link rules.
- Use the suggestions to improve your internal link health score.
- Use the link suggestion in the Ghost editor.