Blogima is a browser extension for Ghost that helps you build and maintain healthy internal links (link suggestions, broken-link detection, blog post health, and more) without leaving your editor.
This guide walks through:
- Installing Blogima from the browser extension store.
- Completing the onboarding setup (exactly as you'll see it in the pop-up).
- What to do after the 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)
- Example:
example.com,blog.example.com
- Example:
- A Ghost Content API key (read-only access to your blog content)
As an example of a Ghost blog, we will use this technical blog hosted 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- Enter your blog configuration
When you open Blogima for the first time. The page asks for the minimum information Blogima needs to connect to your Ghost site and validate it.
The form will ask for two pieces of information:
2.1- The website domain
Enter the domain readers use to reach your blog.
Examples: example.com or blog.example.com
https://, no path)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.
2.2- 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 on "Get started," and many things will happen behind the scenes.
- Verify the domain exists and is running on Ghost.
- Extract the Ghost admin domain and the Ghost version. This is necessary to interact with your blog through the Content API.
- Verify that the content API key of your Ghost blog is valid.
If any of these steps fail, you will get an error message.
If you want to know your Ghost version, read this guide on how to find the Ghost version.
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 it to see more details about your blog score and the score for each 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, such as
example.com.
The content API key is invalid (verify fails)
Double-check:
- You copied the Content API key (not an Admin key).
- Your blog website domain is correct.
Link suggestions are unavailable
This typically means your initial indexing/embeddings are still being processed. Give it a bit of time, then reopen the pop-up. You can continue to fix your internal link health score while waiting.
What to do next
- Add your auto-link rules, which means define a keyword to be associated with an internal link if it is found in another blog post.
- Use the suggestions to improve your internal link health score.
- Use the link suggestion in the Ghost editor to add relevant content to your blog post.