Integration
Once you've created a collection, you need to add the Vellumine script to your Ghost theme so the search bar appears on your blog.
Adding the Script Tag
- In your Ghost admin panel, go to Settings > Code injection.
- In the Site Header section, paste your Vellumine script tag:
<script src="https://app.vellumine.com/search.min.js"
id="vellumine"
data-collection-id="your-collection-id"></script>
- Click Save.
How It Works
When the script loads, it automatically detects Ghost's native search elements and replaces them with Vellumine's search bar. Your readers won't notice any disruption -- the search button in your theme's navigation will open Vellumine's search modal instead of Ghost's.
Readers can also open the search bar with the keyboard shortcut (or on macOS).
Alternative: Theme File Injection
If you prefer to add the script directly to your theme files instead of using Ghost's code injection:
- Open your theme's
default.hbsfile. - Paste the script tag just before the closing
</body>tag. - Save and re-upload your theme.
Automatic Content Syncing
After the initial sync, Vellumine keeps your search index up to date automatically. Whenever you publish, update, or delete a post, page, or tag in Ghost, the changes are reflected in your search index within seconds via webhooks.
The sync status and last sync time are always visible on your collection's dashboard.
Members-Only and Paid Content
Vellumine indexes members-only and paid posts so they appear in search results, but it never exposes the full content to unauthorized readers. Search results show the post title and a brief excerpt, signaling that relevant content exists. Readers who are not subscribed or signed in will need to do so to access the full post.
This makes search a powerful lead magnet -- readers discover your gated content through search and are motivated to subscribe to your publication to read it.
Language Support
Vellumine fully supports Unicode/UTF-8, so search indexing, typo tolerance, and result highlighting work correctly with any language and script -- including CJK characters, Arabic, Cyrillic, Latin diacritics, and emoji. No additional configuration is required.
Verifying the Integration
After adding the script tag:
- Visit your blog.
- Click the search icon in your navigation, or press .
- Type a query -- you should see results from your blog content.
If the search bar doesn't appear, check the browser console for errors and make sure the data-collection-id matches your collection.