Token Limits
Every plan includes a knowledge base with a specific token limit. Understanding these limits helps you make the most of your available context.
What are tokens?#
Tokens are the units AI models use to process text. They're not quite words — they're pieces of words.
A simple conversion: 1 token ≈ 0.75 words
So when you see "30,000 tokens", think roughly 22,500 words.
Common words use 1 token. Longer words might use 2-3 tokens. Punctuation and spaces count too. The AI model breaks down text into these tokens to understand and generate language.
Limits by plan#
Each plan includes a different knowledge base capacity:
- Trial / starter+ / pro+: 30,000 tokens (~22,500 words)
- business+: 50,000 tokens (~37,500 words)
These limits apply per project. If you have multiple projects, each has its own token allowance.
Checking your usage#
The Knowledge Base tab shows your current usage at the top:
Knowledge Base: 8,234 / 30,000 tokens used
This updates in real-time as you add or remove items.
You can also see the token count for individual items when you hover over them, helping you identify which entries use the most capacity.
Staying within limits#
If you're approaching your token limit, here are strategies to manage usage:
Prioritize the most relevant context: What does the AI absolutely need to know? Product features and pricing usually matter more than company history.
Remove outdated entries: Deleted that feature? Changed your pricing? Remove the old context to free up tokens.
Summarize before uploading: Instead of uploading a 50-page product manual, create a condensed version highlighting key points.
Split large topics: Instead of one massive "Product Guide" file, break it into focused items like "Core Features", "Integrations", "Pricing", etc. Then you can remove less critical pieces if needed.
Use concise language: The AI doesn't need flowery marketing copy. Clear, factual descriptions work better and use fewer tokens.
What happens at the limit#
When you've used all available tokens, you cannot add new knowledge base items.
You'll see an error message indicating you're at capacity.
To add new content, you must either:
- Delete existing items to free up tokens
- Upgrade to a plan with a higher token limit
Your existing knowledge base continues working normally. The limit only prevents adding new context.
Upgrading for more capacity#
If you consistently hit your token limit, consider upgrading:
- From starter+ or pro+ to business+: ~67% more capacity (50,000 tokens vs. 30,000)
Navigate to your organization settings and click Billing to view upgrade options.
Tips for efficient token usage#
Test and iterate: Add context gradually. Upload your core documentation, run some test interviews, then add more based on gaps you notice.
Quality over quantity: A focused, well-organized knowledge base of 15,000 tokens often outperforms a sprawling, unfocused one at 30,000 tokens.
Use external links for details: The knowledge base should give the AI context, not serve as a complete encyclopedia. Link to full docs when appropriate.
Review regularly: Set a reminder to review your knowledge base quarterly. Remove what's outdated, update what's changed, and optimize what's staying.