Connecting your first source
Connections are the knowledge sources Onyx learns from. The quality and completeness of your connections directly determines how accurately Onyx can answer questions.
What you can connect
| Type | Description |
|---|---|
| Websites | Deep crawls (all linked pages within a domain) or single-page crawls |
| Text is extracted and indexed from the uploaded file | |
| Markdown (.md) | Uploaded and indexed directly |
| Plain text (.txt) | Uploaded and indexed directly |
| Others | We recommend using markdown.new for free and quick conversions of many formats |
Adding a connection
- Log in to your Onyx dashboard.
- Go to Connections in the left sidebar.
- Click Add Connection.
- Choose the type: URL (web page) or file upload.
- Enter the URL or upload your file.
- Click Save.
Onyx begins indexing immediately. You can watch the status update in real time.
Indexing stages
For web sources, you'll see the connection move through these stages:
Discovering → Extracting → Processing → Comparing → Embedding → Saving
Once a connection completes the Saving stage, it shows as Indexed and Onyx is actively using it to answer questions.
Crawl types and limits
When you add a website URL, Onyx performs a deep crawl — it follows internal links and indexes every page it discovers within your domain. Deep crawls have a per-plan cooldown before they can be re-triggered:
| Plan | Deep crawl cooldown | Single-page crawls / day |
|---|---|---|
| Hobby | 7 days | 5 |
| Starter | 24 hours | 25 |
| Growth | 12 hours | 50 |
| Scale | None | Unlimited |
A single-page crawl re-indexes one specific URL without following links. These count against your daily limit above.
Connection limits
Each crawled page or uploaded file counts as one connection toward your plan's limit:
| Plan | Connection limit |
|---|---|
| Hobby | 100 |
| Starter | 500 |
| Growth | 1,500 |
| Scale | 10,000 |
Enabling and disabling connections
Each connection has an enable/disable toggle. Disabled connections are excluded from search without being deleted. This is useful for temporarily removing a source without losing its indexed content.
What makes a good knowledge source?
Well-structured, clearly written documentation produces better answers. If Onyx gives vague or incomplete answers, check that the relevant content exists in your connected sources and is written in plain language.