Spaces
Micro-applications for content and data storage
Flatfile Spaces are micro-applications, each having their own database, filestore, and auth. Use Spaces to integrate Flatfile into your data exchange workflow, whether that happens directly in your application or as part of an offline process.
You can think of a Space as a home for any one of your Customers’ data, or as place for a discrete data migration session; you can create a new Space any time you need an isolated place to migrate new data.
Terminology note: Spaces are sometimes referred to as “Projects” in Flatfile conversations - this is because we often consider them to be a single import or series of imports from a single end-customer, or, a “Project”.
Anatomy
A Space is comprised of Workbooks, Files, Users, Documents, Themes and Metadata:

- Documents - Custom pages mounted on the Space, displayed in sidebar
- Files - Uploaded directly to a Space for processing
- Users - Admins and configurable Guest Users (temporary or named)
- Metadata - Raw data that you can use for configuration and customizations. Learn more about utilizing metadata effectively.
- Themes - Space-level customization nested in Metadata for branding and appearance
- Workbooks - Blueprint-defined databases containing structured data
- Sheets - Blueprint-defined individual data tables
Creating Spaces
Basic Space Creation
Create a simple Space with Workbook configuration:
Advanced Space Configuration
Configure Space with custom settings:
Space Customization
For advanced UI customization, see Customize Guest Sidebar.
Branding and Theming
For complete theming capabilities, see our comprehensive Theme Your Space guide.
Basic theming example:
Configuration via the Space Configure Plugin
For complete configuration options and advanced usage patterns, see the Space Configure Plugin documentation.
Use the Space Configure Plugin to programmatically set up Spaces with a declarative configuration. The plugin automatically listens for the space:configure
event that’s triggered when a new Space is created: