Skip to content

Reference

Limits

Every size, count, length, time and retry limit of uploads, the CI API, the dashboard and the background jobs.

Limits are grouped by what they bound. A value that an administrator can change is marked and links to where; everything else is fixed in the code. A request over a limit is refused with the messages in Errors and exit codes.

Limit Value
Size of one screenshot 25 MB (26,214,400 bytes). PNG only.
Screenshots per build 10,000. Each upload lists distinct files; the same image used under several names counts once as a file.
Screenshot name 1 to 512 characters, no line breaks or NUL. Unique within a build. From the CLI it is the file's path without .png.
Build name Starts with a letter or digit, then letters, digits, ., _ or -; at most 64 characters. Default default.
Commit SHA 7 to 64 hex characters, stored lowercase. A hosted site needs at least 12.
Branch and base branch 255 characters each.
Ancestor commits sent to find a baseline 2,000 at most. The CLI collects up to 200 first-parent commits and deepens a shallow checkout up to 2,000 commits.
Shards of one parallel build 1 to 1,000. A shard's ID is at most 128 characters, and so is the nonce.
Author fields login 255, email 320, provider 64, providerId 128 characters.
JSON body of POST /v1/builds and finalize 16 MB. On /v2, 4 MB.
Idempotency key 1 to 128 characters.
Shard that never completes The build fails after Upload timeout: 60 minutes by default, 0 to 10,080 (UPLOAD_TIMEOUT_MINUTES). 0 means never.
Files sent at once by the CLI 8
Screenshots of a build kept Until the project's retention removes the build: 30 days by default, 1 to 3,650 days per project. See Retention and cleanup.
What Value
Tries per API call 4
Waits between tries About 0.5, 1 and 2 seconds, each scaled by 50 to 100 percent at random
What is retried Network failures, 429 and 5xx answers
Time per API call 30 seconds; 2 minutes for a file or site upload
--wait polling Every 0.5 seconds, growing by half each time to 2 seconds
--wait timeout --timeout, 600 seconds by default
Limit Value
Unpacked size of one site Largest hosted site: 200 MB by default, 1 to 5,000 (STATIC_SITES_MAX_MB). Instance setting: see Instance settings.
Files in one site 20,000
Expansion An archive may not unpack to more than 100 times its compressed size
Site name The same rule as a build name
Sign-in handoff from the dashboard to a site A single-use token lasts 60 seconds, and the session it opens one hour
Limit Value
Comment 5,000 characters
Rejection reason 2,000 characters
Screenshots in one bulk action 1,000 names per request
Builds in one bulk review, or one bulk review request 50
Reviewers named on a review request or rule 20
Review rule pattern 200 characters
People in a triage rotation 50
Review target 1 to 720 hours (30 days), or none
Snooze default 1 to 30 days. "Tomorrow" and "next week" end at 09:00 UTC.
Time to undo an action from its toast 30 seconds
Gap between nudges for the same overdue review 24 hours
Saved views 100 per person; a name is up to 80 characters
Issue title sent to a tracker 250 characters

A screenshot is judged on the project's default branch over the 10 most recent commits. The number of times it returns to an earlier image before it counts as flaky is 3 by default and can be set per project from 2 up to 8. See Triage and flaky screenshots.

Limit Value
Person's name 1 to 100 characters
Profile picture address 2,048 characters, an http(s) address or a path on this server
Workspace picture PNG, JPEG or WebP up to 1 MB; at least 128 pixels on the shorter side; stored at 256 pixels
Workspace or project name 100 characters
Slug 100 characters for a project or workspace; 60 when an instance admin creates a workspace
Default branch 255 characters
Workspace members added to a project at once 500
Repositories imported at once 50
Domain (workspace or custom site domain) 253 characters; 260 in the custom domain field
Search A query of up to 100 characters; at most 50 results
Branch list 20 by default, up to 100 per request
Password At least 12 characters. The first-run form takes up to 256.
Limit Value
Emailed sign-in code 6 digits, valid for 10 minutes, 5 attempts
Invitation Valid for 7 days
Email address change The confirmation link is valid for 1 hour
Signed file links (screenshots, diffs) Valid for between 1 and 2 hours: a link ends at the end of a fixed one-hour window
Session lookup cache A signed cookie stands in for the session lookup for 30 seconds
Session 7 days, extended on use (at most once a day). No setting
Sign-in rate limit (production) Password sign-in and other /sign-in, /sign-up, change-password and change-email requests: 3 per 10 seconds per client address. Emailed-code requests: 3 per 60 seconds. Other auth endpoints: 100 per 10 seconds. No setting. Project CI tokens have no rate limit
Deleted workspace Restorable for 30 days, then purged
Limit Value
Attempts of a job 5 by default; webhook deliveries 8; the "Send test" delivery 1
Wait before a retry 2 seconds, doubling each time, up to 300 seconds (JOB_RETRY_BASE_SECONDS, JOB_RETRY_MAX_SECONDS)
Finished jobs kept Job retention: 14 days, 0 to 3,650 (JOB_RETENTION_DAYS)
Unused files kept before deletion Unused file grace period: 24 hours, 0 to 8,760 (GC_GRACE_HOURS)
Webhook receiver's time to answer Webhook timeout: 10 seconds, 1 to 600 (WEBHOOK_TIMEOUT_SECONDS)
Webhook deliveries kept 50 per webhook; the dashboard shows the newest 20
GitHub API request 15 seconds, 0.1 to 600 (GITHUB_API_TIMEOUT_SECONDS)
S3 connect and request 10 seconds (1 to 600) and 60 seconds (1 to 3,600) (S3_CONNECT_TIMEOUT_SECONDS, S3_REQUEST_TIMEOUT_SECONDS)
Database connections per process 10 (DATABASE_POOL_MAX, at least 1)
Diff threads One less than the cores, 1 to 256 (CIRCI_DIFF_THREADS), for the js-workers engine only
Readiness check 2 seconds per dependency
Proxy certificate questions 300 per minute for the whole instance
Settings changed in Instance settings Apply within about 30 seconds on every process

Every environment variable named here is described in Environment variables.