# Backup Contents Each 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 files ``` ## Backup 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](/linear/installation-guide.md) - Connect your workspace * [Linear: Restoring Data](/linear/restore.md) - How to restore from a backup * [Password-Protected Archives](/security-and-compliance/password-protected-archives.md) - Encryption details * [Data Deduplication](/managing-backups/data-deduplication.md) - How deduplication works --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.cloudback.it/linear/backup-contents.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.