> ## Documentation Index
> Fetch the complete documentation index at: https://bulkgrid.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Plan Gating and Limits

> Understand how plan boundaries affect collections, runs, and usage-sensitive workflows.

Some product capabilities are explicitly plan-sensitive.

## Confirmed current behavior

Collection creation is gated above the free plan.

That behavior is implemented directly in the collections API. On the free tier, the API returns a structured `forbidden` response with a `LIMIT_COLLECTIONS` code and an `upgrade_plan` upgrade target.

## Other usage-sensitive areas

The product also enforces or tracks usage around areas such as:

* sources
* concurrent runs
* crawled pages
* converted files
* indexed pages per month
* storage
* API calls

## Source access

* Free can subscribe to existing public sources. Creating a new public source requires Pro (`LIMIT_PUBLIC_SOURCE_CREATION_REQUIRES_PRO`).
* Free cannot create private sources (`LIMIT_PRIVATE_SOURCE_CREATION_REQUIRES_PRO`).
* Pro can create public and private sources. There are no source-count caps on public subscriptions or paid source creation.
* Processed pages, retrieval requests, workspace storage, and concurrency remain subject to plan allowances. Free processed pages cover standalone crawl, deep crawl, and extraction work; they do not grant source creation.
* GitHub repository sources require Pro.
* Manual source refresh requires an active or trialing paid plan (`LIMIT_MANUAL_REINDEX`).
* Daily public-source refresh can return `LIMIT_RECRAWL_FREQUENCY` on an unsupported plan.

Read `details.code`, `details.current`, `details.limit`, and `details.upgradeTarget` when present. Reduce the requested workload or change the plan; repeated retries do not resolve a plan restriction. Use the dashboard for your workspace's current allowances rather than hardcoding pricing values.