Connecting Algolia
Algolia is a hosted search-as-a-service option: fast, typo-tolerant search, with docs indexed automatically as you publish. Connecting it replaces the built-in search entirely, taking top priority over SearchWP, Relevanssi, and Ivory Search.
Where to set it up#
Go to WP Super Docs → Settings → Integrations and click the Algolia card to expand it.

Getting your credentials#
Get these from algolia.com → your application → API Keys:
- Application ID
- Search-only API key: a public key, safe to expose in the browser, used for the actual frontend search queries.
- Admin API key: a write key, used only server-side for indexing your docs. This is stored encoded, not in plain text, though treat it as sensitive since it’s obfuscated rather than strongly encrypted.
- Index name: defaults to
wpsd_docsif you leave it blank.
Saving vs. activating#
There are two separate buttons:
- Save: stores your credentials without changing what’s actively powering search. The card’s badge changes to “Configured.”
- Save & use Algolia: stores your credentials and immediately switches docs search over to Algolia. The badge changes to “In use.”
This split matters if you want to set up and test your credentials before actually cutting search over. Once Algolia is in use, a Stop using Algolia button appears if you want to revert back to whichever engine would otherwise be active (SearchWP, Relevanssi, Ivory Search, or native WordPress search).
Testing the connection#
Click Test connection to confirm your Application ID and API key actually work, before relying on it for live search.
Indexing your docs#
Docs are indexed into Algolia automatically going forward: every publish, update, or delete keeps your index in sync without any manual step.
For your existing docs, click Re-index all docs (only shown once Algolia is active) to send everything already published in one batch. This runs immediately when clicked and can take a little while on a large docs site, so stay on the page until it finishes rather than navigating away.
Internal-only docs and docs in a Draft version are never sent to Algolia, since it can’t check who’s logged in. If a doc becomes internal after it was indexed, it’s removed from the index the next time it’s saved, or when you re-index.
Was this helpful?
Thanks for your feedback!
✓ Feedback received. Thank you!