Organizing with Folders
Use folders to organize and control access to your knowledge base content
Folders (also called collections) help you organize your knowledge base content and control which AI personas can access it. Group related documents, websites, and FAQs together for easier management.
Accessing Folders
Folders appear in the folder filter bar on the Train page, just below the stats header.
Why Use Folders
Organization
- Group related content together
- Find content faster
- Maintain clean knowledge base
Visibility Control
- Limit which personas can access specific content
- Create separate content pools for different use cases
- Ensure agents only access relevant information
Bulk Management
- Move multiple items between folders
- Apply settings to entire folders
- Track content by folder
Creating a Folder
- Navigate to Train in the sidebar
- Click the + Add Content button
- Select the Folder option (if available) or create during content addition
- Enter a name for the folder
- Optionally add a description
- Click Create
Or when adding/editing content:
- Open the content edit dialog
- In the Folders section, type a new folder name
- The folder is created automatically
Adding Content to Folders
When Creating Content
- Open the Add Content dialog
- Complete your content
- Select one or more folders in the Folders section
- Save
For Existing Content
- Click on a content item to edit
- Check/uncheck folders in the Folders section
- Save changes
Bulk Assignment
- Select multiple items using checkboxes
- Use the actions dropdown
- Select Add to [Folder Name]
- Items are moved to that folder
Folder Visibility Rules
Folders can restrict which AI personas access their content:
Setting Up Visibility Rules
- Click to edit a folder
- Toggle Limit Visibility on
- Select which Personas can access content in this folder
- Select which Agent Types can access content
- Save the folder
How It Works
When visibility is limited:
- Only selected personas/agent types retrieve content from this folder
- Other agents won't see this content in search results
- Useful for specialized knowledge (e.g., sales-only content)
Example Use Cases
| Folder | Visibility | Purpose |
|---|---|---|
| General FAQ | All agents | Common questions for everyone |
| Sales Materials | Sales agent only | Pricing, proposals, competitor info |
| Technical Docs | Support agent only | Debugging, API details |
| Internal Only | No widget agents | Staff-only information |
Filtering by Folder
On the Train page:
- Click a folder name in the filter bar
- View shows only content in that folder
- Click All to return to full view
The counts next to each folder show how many items it contains.
Managing Folders
Rename a Folder
- Click the folder menu (three dots)
- Select Edit
- Change the name
- Save
Delete a Folder
- Click the folder menu (three dots)
- Select Delete
- Confirm deletion
Deleting a folder doesn't delete its content—items simply become uncategorized.
View Folder Details
Click on a folder to see:
- Total items
- Breakdown by type (documents, websites, FAQs)
- Visibility rules
- Description
Folder Best Practices
Use Descriptive Names
Choose names that clearly indicate contents:
Good:
- "Shipping & Delivery"
- "Account Management"
- "Product Specifications"
Poor:
- "Folder 1"
- "Misc"
- "Old stuff"
Don't Over-Organize
A few well-organized folders work better than many granular ones:
- 5-10 folders is often ideal
- Too many folders make finding content harder
- Consider sub-topics within documents instead
Regular Cleanup
Periodically review folders:
- Archive or delete unused folders
- Consolidate similar folders
- Update visibility rules as needs change
Consistent Assignment
Create guidelines for what goes where:
- Document your folder structure
- Train team on organization
- Review new content placement
Content Without Folders
Content without folder assignments:
- Appears when All filter is selected
- Can be filtered using the Uncategorized option
- Is visible to all personas (unless item-level visibility set)
Use the "Remove from all folders" bulk action to uncategorize content.
Visibility vs Folders
Understanding the difference:
| Feature | Folders | Item-Level Visibility |
|---|---|---|
| Purpose | Organization | Access control |
| Scope | Groups of content | Individual items |
| Inheritance | Items inherit folder rules | Overrides folder rules |
| Management | Folder-level changes | Item-by-item changes |
You can use both together—folder visibility provides defaults, item-level can override.