Collections
Organize documents and manage permissions
R2R provides a powerful and flexible collection system to organize documents and manage access permissions. Collections serve as containers that help you group related content, control access among users, and build knowledge graphs across document sets.
Refer to the collections API and SDK reference for detailed examples for interacting with collections.
Overview
Collections in R2R serve three core purposes:
- Group documents into logical categories for better organization and discovery
- Control access permissions at a collection level rather than per document
- Enable knowledge extraction and insights across related document sets
Each user receives a default collection upon joining R2R, and can create additional collections as needed to organize different types of content.
Collection Management
When you create a collection in R2R, you become its owner and gain full control over its configuration and contents. Collections can contain any number of documents, and a single document can belong to multiple collections simultaneously.
The system maintains a complete audit trail of collection changes, tracking modifications to:
- Collection metadata (name, description, settings)
- Document additions and removals
- User access grants and revocations
- Knowledge graph extractions and updates
When deleting a collection, R2R preserves all documents while removing only the collection structure and associated permissions. This ensures no content is accidentally lost during collection management.
Permission Model
R2R implements a straightforward permission model for collections:
- Collection Owners have full control, including deletion rights and user management
- Collection Members can access and interact with documents based on granted permissions
- Non-Members have no access to the collection or its contents
The permission model ensures documents remain secure while making sharing straightforward. When you add a document to a collection, it automatically inherits the collection’s permission settings.
Document Management
The collection system provides comprehensive tools for organizing and managing documents. You can view collection contents, filter documents by various criteria, and perform batch operations across document sets.
Key document management features include:
- Adding documents during or after initial ingestion
- Removing documents without affecting the original content
- Filtering and searching within collection contents
- Exporting document lists and collection metadata
Knowledge Graph Integration
Collections in R2R integrate deeply with the knowledge graph system. When enabled, R2R processes documents within collections to:
- Extract entities and relationships from document content
- Build semantic connections between related documents
- Generate collection-level insights and summaries
- Enable semantic search across collection contents
Enterprise Features
The following features are restricted to:
- Self-deployed instances
- Enterprise tier cloud accounts
Contact our sales team for pricing and availability.
Enterprise deployments gain access to advanced collection capabilities including:
- Hierarchical collections for complex organizational structures
- Collection templates for standardized content organization
- Automated permission sync with external systems
- Advanced analytics and reporting
- Custom metadata fields
- Comprehensive audit logging
Conclusion
Collections form the foundation of document organization and access control in R2R. Through their flexible design and powerful features, they enable teams to create organized, secure, and collaborative document management systems. Whether managing a small team’s documents or implementing enterprise-wide content organization, collections provide the tools needed for effective document management.