Integration

Add Vellumine's search bar to your Ghost blog.

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

  1. In your Ghost admin panel, go to Settings > Code injection.
  2. 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>
  1. Click Save.
You can also find your script tag at any time in the Vellumine dashboard under your collection's home page, in the Search Integration section.

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:

  1. Open your theme's default.hbs file.
  2. Paste the script tag just before the closing </body> tag.
  3. 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.

Author changes are not covered by Ghost webhooks. If you add or update an author, trigger a manual sync from the Settings page of your collection to reflect the changes.

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:

  1. Visit your blog.
  2. Click the search icon in your navigation, or press .
  3. 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.