Skip to main content

Getting Started

Embed a search widget on your help center in 5 minutes

March 22, 2026 · 3 min read

Adding semantic search to your help center doesn't require a backend team, an ML pipeline, or weeks of integration work. Here's how to do it in under 5 minutes.

Step 1: Create a project (30 seconds)

A project is a container for the documents you want to make searchable. Think of it as a scope — one project per help center or documentation site.

Go to Content in your dashboard and click New project. Give it a name like "Help Center" or "API Docs."

Step 2: Add your documents (2 minutes)

You have four options:

  • Fetch URL — paste a single article URL and we'll extract the content
  • Crawl site — give us your sitemap URL and we'll discover all your pages
  • Write manually — paste or type content directly
  • CSV upload — bulk import from a spreadsheet
  • For most help centers, the Crawl site option is fastest. Paste your sitemap URL (usually https://yoursite.com/sitemap.xml), preview the discovered pages, select the ones you want, and import.

    Documents are automatically queued for indexing. Within a minute or two, they'll be searchable.

    Step 3: Create a widget site (30 seconds)

    Go to Widget Sites and click Create widget site. Pick a name and select the project you just created.

    You'll get a public key — this is what identifies your widget.

    Step 4: Embed the script (30 seconds)

    Copy the script tag from the Installation tab:

    <script src="https://your-domain.com/widget.js" data-key="your-public-key" defer></script>

    Paste it into your website's HTML, just before the closing </body> tag. That's it.

    Step 5: Test it (30 seconds)

    Open your website and look for the search button in the bottom-right corner. Click it and try a search. You should see results from your imported documents.

    What you get out of the box

  • Semantic search — understands meaning, not just keywords
  • Dark mode — automatically matches your site's color scheme
  • Mobile-friendly — full-screen overlay on small screens
  • Keyboard shortcut — Cmd+K / Ctrl+K opens the widget
  • Recent searches — remembers what users searched before
  • Customizable — change colors, position, placeholder text from the dashboard
  • Next steps

    Once your widget is live, check the Analytics page to see how search is performing. Look for zero-result queries — these are opportunities to add content or synonym rules to improve results.