Backup Contents
Detailed breakdown of all Linear workspace data included in Cloudback backups, including issues, projects, documents, cycles, templates, and embedded files.
LinearEach Cloudback backup of a Linear workspace creates an encrypted ZIP archive containing a complete snapshot of your workspace data. This page details everything that is included.
Summary
A Linear backup includes 23 data categories covering all core workspace entities:
| Category | Storage Format | Description |
|---|---|---|
| Workspace | Single JSON file | Workspace metadata (name, URL, logo) |
| Users | Single JSON file | All workspace members with profiles |
| Teams | Individual JSON per team | Team settings, cycle config, members |
| Issues | Individual JSON per issue | Full issue data with labels, assignees, states |
| Comments | Individual JSON per comment | Issue/document/project comments with threads |
| Projects | Individual JSON per project | Project details, members, external links |
| Cycles | Individual JSON per cycle | Sprint/cycle data per team |
| Documents | Individual JSON per document | Rich-text documents |
| Initiatives | Individual JSON per initiative | Strategic initiatives with links |
| Templates | Individual JSON per template | Issue, project, and document templates |
| Custom Views | Individual JSON per view | Saved filters and views |
| Workflow States | Single JSON file | All workflow states across teams |
| Issue Labels | Single JSON file | Issue label hierarchy |
| Project Labels | Single JSON file | Project-specific labels |
| Project Statuses | Single JSON file | Available project status definitions |
| Attachments | Single JSON file | Attachment metadata and URLs |
| Issue Relations | Individual JSON per relation | Blocks/duplicates/relates-to links |
| Project Updates | Individual JSON per update | Project status updates |
| Initiative Updates | Individual JSON per update | Initiative status updates |
| Project Milestones | Individual JSON per milestone | Project milestone targets |
| Initiative-to-Project Links | Single JSON file | Initiative-project relationships |
| External Users | Single JSON file | External/guest user profiles |
| Embedded Files | Downloaded files + manifest | Images and attachments from content fields |
Archive Structure
backup.zip
├── metadata.json # Backup version, workspace ID, statistics
├── workspace.json # Workspace metadata
├── users.json # All workspace users
├── workflow-states.json # All workflow states
├── labels.json # Issue labels
├── project-labels.json # Project labels
├── project-statuses.json # Project status definitions
├── attachments.json # Attachment metadata
├── initiative-to-projects.json # Initiative-project links
├── external-users.json # External/guest users
├── teams/
│ ├── {teamId}.json # Per-team data with settings
│ └── ...
├── issues/
│ ├── {issueId}.json # Per-issue data
│ ├── index.json # Sorted index of all issues
│ └── ...
├── comments/
│ ├── {commentId}.json # Per-comment data
│ └── ...
├── projects/
│ ├── {projectId}.json # Per-project data
│ └── ...
├── cycles/
│ ├── {cycleId}.json # Per-cycle data
│ └── ...
├── documents/
│ ├── {documentId}.json # Per-document data
│ └── ...
├── views/
│ ├── {viewId}.json # Per-custom-view data
│ └── ...
├── initiatives/
│ ├── {initiativeId}.json # Per-initiative data
│ └── ...
├── templates/
│ ├── {templateId}.json # Per-template data
│ └── ...
├── project-updates/
│ ├── {updateId}.json # Per-project-update data
│ └── ...
├── initiative-updates/
│ ├── {updateId}.json # Per-initiative-update data
│ └── ...
├── issue-relations/
│ ├── {relationId}.json # Per-issue-relation data
│ └── ...
├── project-milestones/
│ ├── {milestoneId}.json # Per-milestone data
│ └── ...
└── files/
├── manifest.json # File download manifest
└── {hash-based-filename} # Downloaded embedded filesBackup Statistics
Each backup includes a metadata.json file with detailed statistics:
- Issue count, project count, team count
- Document count, cycle count, comment count
- Label count, project label count, user count
- Attachment count, custom view count, initiative count
- Template counts (issue, project, document separately)
- Project update count, initiative update count
- Issue relation count, project milestone count
- External user count
- Embedded file count (successful + failed + total size in bytes)
These statistics are displayed on the Workspace Details page in the Cloudback dashboard.
Learn More
- Linear: Getting Started - Connect your workspace
- Linear: Restoring Data - How to restore from a backup
- Password-Protected Archives - Encryption details
- Data Deduplication - How deduplication works