Site-wide Documents
Set-up Guide
Making your Ghost site discoverable by AI assistants takes only a few minutes with Visiting Objects GEO for Ghost. Follow the steps below to set up llms.txt and AI-readable content for your site.
Prerequisites
- A Ghost v5 site running at a public URL (self-hosted or Ghost Pro).
- Access to the Ghost admin panel with permission to create Custom Integrations (required for API keys).
- A Visiting Objects account with an active GEO for Ghost plan.
Step 1: Create a new GEO Instance
- Log in to the Visiting Objects dashboard and navigate to the GEO Instances page.
- Click + Create GEO Instance or + New Instance.
Step 2: Enter the Ghost site URL
- In Ghost URL, enter the full site address, including
https://(for examplehttps://yourblog.com). - Click Continue.
- Visiting Objects automatically scans your Ghost instance and pre-fills everything it can, from your site name to the API URL and configuration.
Step 3: Provide API keys
The only manual input usually required is the two API keys:
| Key | Where to find it in Ghost | Purpose |
|---|---|---|
| Content API Key | Settings > Integrations > Add custom integration | Read published posts and pages for optimization |
| Admin API Key | Same custom integration card ("Admin API Key") | Register webhooks so new or updated content is optimized automatically |
- Paste both keys in the New GEO Instance form.
- Click Create.
Step 4: Watch the set-up progress
A progress panel tracks the automated setup jobs:
| Task | Description |
|---|---|
| Create GEO Instance | Allocates your optimization engine |
| Analyze Content | Scans your existing posts and pages |
| Auto Sync | Registers update webhooks via the Admin API |
You can leave the page; processing continues in the background.
Step 5: Configure Optimization Settings
Once setup is complete, configure your optimization preferences:
- Navigate to Settings in your GEO instance.
- Review and adjust optimization settings as needed.
- Click Save to apply changes.
Step 6: Verify the Setup
To confirm everything is working:
- Visit your GEO instance dashboard.
- Check that your posts appear in the content list.
- Verify the connection status shows "Connected".
You can also test the connection by publishing or updating a post in Ghost and confirming it appears in your GEO dashboard.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| No content showing | Content API key invalid | Regenerate the key in Ghost and update the instance |
| New posts not appearing | Admin API key missing or webhook disabled | Add a valid Admin API key to enable automatic sync |
| Connection errors | Ghost URL incorrect | Verify the URL includes https:// and is publicly accessible |
Support
Email support@visitingobjects.com with your site URL and a short description of the issue. Attach screenshots or logs where possible to speed up resolution.
Back to GEO for Ghost | Need help? Contact Support