Linear 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 comprehensive 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