53 lines
2.5 KiB
Text
53 lines
2.5 KiB
Text
---
|
|
title: How does it work?
|
|
description: Learn how DocSearch crawls, indexes, and serves documentation content.
|
|
---
|
|
|
|
import useBaseUrl from '@docusaurus/useBaseUrl';
|
|
|
|
DocSearch setup has three parts: join the DocSearch program, index your content, and add a frontend package or framework integration.
|
|
|
|
<img
|
|
src={useBaseUrl('img/assets/docsearch-how-it-works.png')}
|
|
alt="How it works"
|
|
/>
|
|
|
|
## You apply
|
|
|
|
First, confirm that [your website qualifies][2], then [apply for DocSearch][1]. The onboarding flow validates your domain against the program requirements.
|
|
|
|
If automated validation can't determine eligibility, the application might require a manual review.
|
|
|
|
## Index your content
|
|
|
|
After approval, create a dedicated [crawler][5] in your Algolia application. Its [configuration file][6] defines which URLs to crawl, which URLs to ignore, and which selectors extract your content hierarchy.
|
|
|
|
Run a test crawl, review the extracted records, and configure recurring crawls. Use the Crawler interface to adjust the configuration as your website changes.
|
|
|
|
**With the Crawler, comes [a dedicated interface][8] for you to:**
|
|
|
|
- Start, schedule and monitor your crawls
|
|
- Edit and test your crawler configuration
|
|
|
|
**With the Algolia application comes access to the dashboard for you to:**
|
|
|
|
- Browse your index and see how your content is indexed
|
|
- Review analytics to understand how search performs
|
|
- Trials for other Algolia features
|
|
- Team management
|
|
|
|
## Add DocSearch to your website
|
|
|
|
Choose a [DocSearch v5 package][7] or [supported framework integration][9]. Configure it with your application ID, Search API key, and index name. The frontend queries the Algolia index and displays the results.
|
|
|
|
Crawler versions, record schema versions, and frontend package versions are separate. In particular, crawler `recordVersion: 'v3'` describes the indexed record schema, not the DocSearch UI version. You can upgrade the v5 frontend packages without recreating the crawler. Keep the "Search by Algolia" logo next to your search results.
|
|
|
|
[1]: https://dashboard.algolia.com/users/sign_up?selected_plan=docsearch&utm_source=docsearch.algolia.com&utm_medium=referral&utm_campaign=docsearch&utm_content=apply
|
|
[2]: /docs/who-can-apply
|
|
[3]: https://github.com/algolia/docsearch-configs/tree/master/configs
|
|
[4]: /docs/packages/css/styling
|
|
[5]: https://www.algolia.com/products/search-and-discovery/crawler/
|
|
[6]: https://www.algolia.com/doc/tools/crawler/apis/configuration/
|
|
[7]: /docs/packages/overview
|
|
[8]: https://dashboard.algolia.com/crawler
|
|
[9]: /docs/integrations
|