> For the complete documentation index, see [llms.txt](https://cloudback.it/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cloudback.it/docs/linear/backup-contents.md).

# Backup Contents

Detailed breakdown of all Linear workspace data included in Cloudback backups, including issues, projects, documents, cycles, templates, and embedded files.

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](/docs/linear/installation-guide.md) - Connect your workspace
* [Linear: Restoring Data](/docs/linear/restore.md) - How to restore from a backup
* [Password-Protected Archives](/docs/security-and-compliance/password-protected-archives.md) - Encryption details
* [Data Deduplication](/docs/managing-backups/data-deduplication.md) - How deduplication works