Cloud Data Retention Policy and Settings

Cloud Data Retention Policy

CircleCI implements a data retention policy to maintain optimal performance and reliability across our platform. This policy determines how long we store your build data and other pipeline-related information.

What is Build Data?

Build data includes:

• All pipeline runs
• Workflows within those pipelines (including reruns)
• Jobs within those workflows
• Information viewable in the CircleCI UI or retrievable via API

Note: Workspaces, caches, and artifacts have separate retention policies that can be customized.

Retention Periods by Plan

Our data retention periods vary based on your subscription plan:

Attempting to access pipeline data that precedes your plan's retention period you will receive a 404 error in the UI or in the API response.

Customizing Storage Retention

You can set custom retention periods for artifacts, workspaces, and caches to optimize storage usage and costs.

To access the usage controls:

1. Log in to your CircleCI account
2. Navigate to Organization Settings (click on your organization name in the top left)
3. Select Plan from the left sidebar
4. Click on Usage Controls

Additional Resources

Data Retention Policy Update Announcement

Custom Storage Controls