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