Limits
Buildkite service quotas limit resource usage across your organization. Limits vary by plan and during the All Access Trial.
This page lists default limits. To check your organization's current limits, see Viewing your organization's service quotas. For available plans and their features, see Pricing.
The Usage page is available on every Buildkite plan and shows a breakdown of usage metrics across the Buildkite platform and all products for your Buildkite organization.
Viewing your organization's service quotas
Buildkite organization administrators can view the service quotas that apply to their organization on the Service Quotas page in Organization Settings.
To access your organization's service quotas:
Select Settings in the global navigation to access the Organization Settings page.
-
Select Quotas to open the Service Quotas page.
The Service Quotas page displays your organization's current limits grouped by product area. Each quota shows the limit that applies to your organization, which may differ from the defaults listed on this page.
A Custom badge next to a quota indicates that your organization has a limit that differs from the default for your plan. An Exceeded in last 24h badge indicates that your organization reached this limit within the past 24 hours.
Some organization-level limits can be increased on request depending on your plan. Contact Buildkite support at support@buildkite.com with details about your use case, or contact your Technical Account Manager if you have one.
Platform and organization-level limits
These limits apply across Buildkite products.
| Service limit type | Description | Default limit | |||
|---|---|---|---|---|---|
| Service limit type | Organizations per day | Description | The maximum number of organizations a user can create per day. | Default limit | 4 organizations |
| Service limit type | Organizations per user | Description | The maximum total number of organizations a user can create. | Default limit | 20 organizations |
| Service limit type | Unverified emails per user | Description | The maximum number of unverified emails per user. | Default limit | 5 emails |
| Service limit type | Invitations per organization | Description | The maximum number of pending invitations for an organization. | Default limit | 20 invitations |
| Service limit type | Teams per organization | Description | The maximum number of teams that an organization can have. | Default limit | 250 teams |
| Service limit type | REST API rate limit per organization | Description | The number of requests an organization can make to Organization endpoints on the REST API, per minute. | Default limit | 200 requests per minute |
| Service limit type | GraphQL API rate limit per organization | Description | The total actual complexity points an organization can consume on the GraphQL API within a 5-minute window. | Default limit | 20,000 complexity points per 5 minutes |
| Service limit type | Portal API rate limit per organization | Description | The number of requests an organization can make to Organization endpoints on the Portal API, per minute. | Default limit | 200 requests per minute |
| Service limit type | REST API rate limit per user | Description | The default number of per-user requests a single user can make to the REST API, per minute. This limit applies in addition to the organization-wide REST API rate limit. | Default limit | 50 requests per minute |
| Service limit type | GraphQL API rate limit per user | Description | The default per-user complexity points a single user can consume on the GraphQL API within a 5-minute window. This limit applies in addition to the organization-wide GraphQL API rate limit. | Default limit | 5,000 complexity points per 5 minutes |
| Service limit type | Remote MCP server rate limit per user | Description | The number of REST API requests a user can make through the remote Buildkite MCP server, per minute. This limit is separate from the organization-wide REST API rate limit. | Default limit | 50 requests per minute |
| Service limit type | GraphQL query complexity | Description | The maximum complexity score for GraphQL queries. | Default limit | 50,000 |
| Service limit type | GraphQL query depth | Description | The maximum nesting depth for GraphQL queries. | Default limit | 15 levels |
| Service limit type | Audit search terms | Description | The maximum number of search terms for audit logs. | Default limit | 3 terms |
| Service limit type | IP addresses per token | Description | The maximum number of IP allowlist entries per token. | Default limit | 24 addresses |
| Service limit type | Maximum OIDC lifetime | Description | The default maximum lifetime for OIDC. | Default limit | 2 hours |
Pipelines limits
The following table lists the default service limits for Buildkite Pipelines.
| Service limit type | Description | Default limit | |||
|---|---|---|---|---|---|
| Service limit type | Jobs per build | Description | The maximum number of jobs that can be created in a single pipeline build (including job retries). | Default limit | 4,000 jobs |
| Service limit type | Jobs created per pipeline upload | Description | The maximum number of jobs that can be created in a single pipeline upload. | Default limit | 500 jobs |
| Service limit type | Job timeout | Description | The maximum time before a running job will time out. | Default limit | 4 hours on the Free plan. Unlimited on Pro and Enterprise plans |
| Service limit type | Pipeline uploads per build | Description | The maximum number of pipeline uploads that can be performed in a single build. | Default limit | 500 pipeline uploads |
| Service limit type | Triggers per pipeline | Description | The maximum number of webhook triggers per pipeline. | Default limit | 10 |
| Service limit type | Trigger build depth per pipeline | Description | The maximum depth of a chain of trigger builds. | Default limit | 10 builds |
| Service limit type | Concurrency key length | Description | The maximum length for concurrency group keys. | Default limit | 200 characters |
| Service limit type | Build retention | Description | The time period builds are stored in Buildkite Pipelines after running. | Default limit | 30 days on the Free plan, 90 days on the Pro plan, and 365 days on the Enterprise plan |
| Service limit type | Teams per block step | Description | The maximum number of allowed teams for manual unlock steps. | Default limit | 100 teams |
| Service limit type | Matrix jobs per step | Description | The maximum number of matrix jobs in a pipeline step. | Default limit | 50 jobs |
| Service limit type | Annotation replacements | Description | The maximum number of image or link replacements per annotation. | Default limit | 10 replacements |
| Service limit type | Artifacts per job | Description | The maximum number of artifacts that can be uploaded to Buildkite Pipelines per job. | Default limit | 5000 artifacts |
| Service limit type | Artifact file size | Description | The maximum size of an artifact that can be uploaded to Buildkite Pipelines from an agent. | Default limit | 10 GiB |
| Service limit type | Artifact batch total file size | Description | The maximum cumulative size of artifacts that can be uploaded to Buildkite Pipelines from an agent in a single job using the buildkite-agent artifact upload command. |
Default limit | 50 GiB |
| Service limit type | Multipart upload artifacts | Description | The maximum number of artifacts per upload batch. | Default limit | 30 artifacts |
| Service limit type | Artifact retention | Description | The maximum number of days artifacts are stored. See Artifacts billing for how retention relates to storage usage. | Default limit | 30 days on the Free, Personal, and Pro plans, 90 days on the Enterprise plan and during trials, and 180 days on earlier paid plans, such as Pro and Enterprise plans from before 2026 |
| Service limit type | Log size per job | Description | The maximum file size of a job's log. | Default limit | 1,024 MiB |
| Service limit type | Number of clusters | Description | The maximum number of clusters that can be created in a Buildkite organization. | Default limit | 1 on the Free plan, unlimited on Pro and Enterprise plans |
| Service limit type | Number of queues per cluster | Description | The default number of queues that can be created on a single cluster. | Default limit | 50 |
| Service limit type | Portal secrets | Description | The maximum number of secrets per portal. | Default limit | 2 secrets |
| Service limit type | Number of stacks per organization | Description | The default number of stacks that can be created per organization. | Default limit | 30 |
| Service limit type | Cache size for hosted agents | Description | The maximum cache size for hosted agents. | Default limit | 128 GB |
| Service limit type | Artifact Create/Update API calls | Description | The number of Create or Update requests for artifacts per minute per organization. | Default limit | 600 |
| Service limit type | Slack services per organization | Description | The maximum number of Slack services that can be added to an organization. | Default limit | 50 services |
| Service limit type | Webhook services per organization | Description | The maximum number of Webhook services that can be added to an organization. | Default limit | 15 services |
| Service limit type | Event Log API services per organization | Description | The maximum number of Event Log API services that can be added to an organization. | Default limit | 15 services |
| Service limit type | OpenTelemetry Tracing services per organization | Description | The maximum number of OpenTelemetry Tracing services that can be added to an organization. | Default limit | 5 services |
| Service limit type | Datadog Pipeline Visibility services per organization | Description | The maximum number of Datadog Pipeline Visibility services that can be added to an organization. | Default limit | 5 services |
| Service limit type | AWS EventBridge services per organization | Description | The maximum number of AWS EventBridge services that can be added to an organization. | Default limit | 1 service |
| Service limit type | Anthropic spend | Description | Model provider spend limits for Anthropic, per month in USD. | Default limit | $50 during the All Access Trial, $1,000 on Pro and Enterprise |
| Service limit type | OpenAI spend | Description | Model provider spend limits for OpenAI, per month in USD. | Default limit | $50 during the All Access Trial, $1,000 on Pro and Enterprise |
Hosted agents limits
Buildkite hosted agent concurrency limits the combined vCPU capacity of machines allocated to your organization. Each machine runs one job and uses the vCPU capacity specified by its instance shape. Machines count toward concurrency from boot until release.
| Limit type | All Access Trial | Free | Pro | Enterprise | |||||
|---|---|---|---|---|---|---|---|---|---|
| Limit type | Linux AMD64 vCPU concurrency | All Access Trial | 24 vCPU | Free | 20 vCPU | Pro | 256 vCPU | Enterprise | Custom |
| Limit type | Linux ARM64 vCPU concurrency | All Access Trial | 24 vCPU | Free | Not available | Pro | 64 vCPU | Enterprise | Custom |
| Limit type | M4 Mac vCPU concurrency | All Access Trial | 12 vCPU | Free | Not available | Pro | 48 vCPU | Enterprise | Custom |
| Limit type | Windows vCPU concurrency | All Access Trial | 24 vCPU | Free | Not available | Pro | 64 vCPU | Enterprise | Custom |
| Limit type | Linux AMD64 vCPU minutes per month | All Access Trial | 4,000 included | Free | Up to 2,000 | Pro | 4,000 included | Enterprise | Volume discounts |
| Limit type | Linux ARM64 vCPU minutes per month | All Access Trial | 4,000 included | Free | Not available | Pro | Pay as you go | Enterprise | Volume discounts |
| Limit type | M4 Mac vCPU minutes per month | All Access Trial | 3,000 included | Free | Not available | Pro | Pay as you go | Enterprise | Volume discounts |
| Limit type | Windows vCPU minutes per month | All Access Trial | 4,000 included | Free | Not available | Pro | Pay as you go | Enterprise | Volume discounts |
Adjusting hosted agents limits
All Access Trial and Enterprise hosted agents limits can be increased on request. Contact Buildkite support at support@buildkite.com with details about your use case, or contact your Technical Account Manager if you have one.
To calculate the maximum number of concurrent jobs using one instance shape, divide your vCPU concurrency limit by the shape's vCPU count. For example:
- The Free plan's 20-vCPU Linux AMD64 limit supports up to 10 Small machines at two vCPU each.
- The Pro plan's 256-vCPU Linux AMD64 limit supports up to 128 Small machines, 64 Medium machines at four vCPU each, or 32 Large machines at eight vCPU each.
For a mix of shapes, the combined vCPU capacity must stay within the limit. Jobs that would exceed it remain queued until capacity becomes available.
The following default storage quotas apply to hosted agent cache volumes:
| Storage quota | Default |
|---|---|
| Container cache volume | 50 GB |
| Git mirror volume | 5 GB |
vCPU minute allowances and usage pricing are separate from concurrency limits. See Pricing for current usage rates, available Linux, macOS, and Windows shapes, and hosted agent features included with each plan.
Test Engine limits
The following table lists the default service limits for Test Engine.
| Service limit type | Description | Default limit | |||
|---|---|---|---|---|---|
| Service limit type | Test Engine workflows per suite | Description | The maximum number of Test Engine workflows per suite. | Default limit | Not available on the Free plan, 1 workflow on the Pro plan, 3 workflows on the Enterprise plan |
| Service limit type | Test Engine workflow events per minute | Description | The maximum number of Test Engine workflow events per minute. | Default limit | 500 events |
| Service limit type | Test Splitting API rate limit | Description | The number of requests that can be made to the Test Splitting API. | Default limit | 10,000 requests per minute |
| Service limit type | Test ownership file size | Description | The maximum size for CODEOWNERS files. | Default limit | 1 MB |
| Service limit type | Linear services per organization | Description | The maximum number of Linear integrations that can be added to an organization. | Default limit | 1 service |
Package Registries limits
The following table lists the default service limits for Buildkite Package Registries. The limits in Package Registries are based on the subscription tier:
| Plan | Description | Default limit | |||
|---|---|---|---|---|---|
| Plan | Free plan | Description | Allocated storage and bandwidth volume (combined). | Default limit | 1 GB per month (hard limit) |
| Plan | Pro plan | Description | Allocated storage and bandwidth volume (combined). | Default limit | 20 GB included per organization per month, then usage-based billing |
| Plan | Enterprise plan | Description | Allocated storage and bandwidth volume (combined). | Default limit | Custom allocation with volume pricing |