Billing Folders lets workspace administrators track and manage billable usage at the folder level.
Billing Folders is a premium feature available for Enterprise plans. To enable Billing Folders for your workspace, contact the Roboflow sales team or your account representative. For more information on available plans, visit our pricing page.
When enabled, all usage (ex: training, inference, image storage, labeling, and more) is automatically attributed to the folder that contains the project being used. This gives organizations granular cost visibility and spending control across teams, departments, or clients.
How Usage Attribution Works
When Billing Folders is enabled, each folder in your workspace receives its own API key. All billable usage that occurs within a folder's projects is tracked against that folder's API key. This means you can see exactly how much each folder is consuming in your usage reports and dashboard.
Usage attribution is automatic. You do not need to manually assign usage to folders. It flows from the project to its parent folder.
Image Storage Attribution
Image storage is attributed to the folder that contains the project(s) referencing the image.
If an image is shared across multiple projects within the same folder (or within subfolders of the same parent), storage is attributed to the deepest folder that contains all of the projects using that image:
Workspace
├── Folder A
│ ├── Project 1 ← image.jpg
│ └── Project 2 ← image.jpg (shared)
└── Folder B
└── Project 3
image.jpg storage is attributed to Folder A (the deepest folder containing all projects that reference it)
If an image is shared across projects in different root folders with no common parent folder, storage is attributed at the workspace level:
Workspace
├── Folder A
│ └── Project 1 ← image.jpg
└── Folder B
└── Project 2 ← image.jpg (shared)
image.jpg storage is attributed to the Workspace (no single folder contains both projects)
Workspace administrators can temporarily pause all billable usage within a folder. This is useful for controlling costs or preventing accidental usage.
Pausing a Folder
To pause a folder, open the Folder Settings modal and toggle Pause Folder Usage.
When a folder is paused:
All API keys belonging to that folder are disabled
Any API request that would incur usage against that folder is rejected with a 423 Locked status code
No new billable usage is recorded for the folder
You can also pause a folder and all of its descendant folders at once by toggling Pause All Descendant Folders' Usage. This disables API keys for the selected folder and every folder nested beneath it.
Resuming a Folder
To resume a paused folder, return to the "Folder Settings" modal and toggle the pause control off. This re-enables the folder's API keys and restores normal operation. Similarly, you can resume a folder and all of its descendants at once.
Resuming only affects keys that were paused by the folder pause feature. Keys that were disabled for other reasons are not affected.
Folder API Keys
When Billing Folders is enabled, each folder automatically receives its own API key. These keys are used internally to track which folder billable usage belongs to.
Viewing keys: Open the Folder Settings modal and navigate to the API Keys tab to see the API keys associated with a folder.
Automatic creation: API keys are created automatically when folders are created or when Billing Folders is first enabled on your workspace. You do not need to create them manually.
Common Scenarios
Scenario
What Happens
Moving a project to a different folder
Future usage for that project is attributed to the new folder. Historical usage remains attributed to the original folder.
Deleting a folder
The folder is removed from your workspace. Child projects and sub-folders are reassigned to the parent folder. Historical usage data is preserved in billing reports.
Creating new folders
New folders automatically receive an API key for billing attribution. No additional setup is required.
Disabling Billing Folders
Folder-level attribution stops. New usage is tracked at the workspace level only. Historical usage data from the folder billing period is preserved.
