Schema Visualization Guide
Core FeatureLearn how to visualize, analyze, and understand your Firestore database structure with interactive schema tools.
Schema visualization automatically analyzes your Firestore collections and generates detailed schema information, including field types, nested objects, and example values. This helps you understand your database structure at a glance.
Getting Started
Select Collections
On the Schema Analysis tab, you'll see all available collections in your Firebase project. Click on collection names to select them for analysis.
Review Generated Schema
Once analysis completes, you'll see a detailed breakdown of each collection's structure:
- Field names and types - All detected field types with examples
- Nested objects - Hierarchical structure of complex objects
- Array contents - Type information for array elements
- Sample values - Real examples from your data
Explore Your Data
Use the "View Records" button to browse actual documents in each collection, or switch to the AI Relationships tab to discover connections between collections.
Understanding Data Types
Primitive Types
- string - Text values
- number - Integers and floats
- boolean - True/false values
- null - Null values
Complex Types
- timestamp - Firestore timestamps
- geopoint - Geographic coordinates
- reference - Document references
- array - Lists of values
- object - Nested documents
Configuration Options
Schema analysis uses configurable sample sizes to balance accuracy with performance:
Default Sample Sizes
- Schema Generation: 100 documents per collection
- AI Analysis: 1-500 documents (configurable)
- Record Browsing: 10-100 documents per page
Best Practices
- ✓Start with smaller collections to understand the schema format
- ✓Use "Clear Selection" to reset analysis when switching projects
- ✓Analyze related collections together for better relationship discovery
- 💡Schema represents common patterns - some documents may have additional fields
- 💡Example values show real data from your collections (first 40 characters)
- 💡Nested objects display hierarchical field relationships
Troubleshooting
No collections found
Verify that your Firebase project has Firestore collections and that your service account has proper read permissions.
Schema generation fails
Check your internet connection and ensure the collection contains readable documents. Empty collections will show "No fields found."
Slow analysis
Large collections (1000+ documents) may take 10-30 seconds to analyze. Consider analyzing fewer collections simultaneously.
Explore Related Features
Once you understand your schema, explore your data with advanced browsing and discover hidden connections between your collections using AI analysis.