Automatic backups

BugBug backs up every project once a day on paid plans. Download a backup as a ZIP and restore it as a new project whenever you need it.

On paid plans, BugBug backs up every project once a day and keeps each backup for as long as your plan allows. There is nothing to set up. The backups collect in project settings, and you download the one you need.

A backup is a full project export: the same ZIP you would download yourself, only BugBug makes it for you.

---

What a backup contains

A backup holds everything a manual project export holds:

• tests, reusable components, suites, and profiles

• project settings, selectors, waiting conditions, and screen sizes

• the folder structure

• files your tests use, in artifacts/: upload attachments and visual regression baselines

It does not contain run history, screenshots captured during runs, or logs. See Exporting for the full list.

A backup contains secret values in plain text, exactly like a manual export. Profile variables marked as secret, values typed by type steps, and basic authentication credentials are all written with their real values.

Treat a downloaded backup like a .env file: keep it out of shared drives and public repositories.

---

Schedule and retention

Backups run once a day, starting shortly after 03:15 UTC, and a project gets at most one per day. Packing a project takes time and every project is queued in the same run, so a new backup usually appears between 03:15 and 04:00 UTC. Large projects can land later. The app prints the start time of the next run above the list.

How long a backup stays available depends on your plan:

Plan	Backups kept for
Free	not available
Core	7 days
Pro	14 days
Business	30 days

During a trial you get the Pro retention of 14 days.

Once a backup passes its retention period it drops off the list and can no longer be downloaded. If you need a copy for longer than that, download it and store it yourself.

Retention is counted per backup, from the moment it was created. Changing your plan does not extend the backups you already have - it changes how long the next ones are kept.

---

Find and download a backup

1. Go to Project settings → Export & Backup.

2. Pick a backup from the list. The newest are first, with the date each one was taken and how many tests and suites it contains. Use Show older to see the rest.

3. Click Download in the row you need. The file arrives as project_<slug>_<date>.zip, for example project_shop_2026-08-10.zip.

---

Restore from a backup

Restoring means importing the downloaded ZIP:

1. Download the backup you want.

2. Go to your project list.

3. Choose Import project and select the ZIP.

A project import always creates a new project. It never overwrites the project the backup came from, so you can restore an old state next to the current one and compare them before deciding what to keep. See Importing for what happens to slugs and conflicts.

To recover a single test, import the backup as a new project, export that one test from it, then import the test into your original project.

---

Backups through the API

The Public API exposes the same list and downloads. Authenticate as you would for any other v2 endpoint:

List project backups

curl -L \
  -H "Authorization: Token <api-token>" \
  "https://api.bugbug.io/v2/projects/<project-id>/backups/"

Download a project backup

curl -L \
  -H "Authorization: Token <api-token>" \
  "https://api.bugbug.io/v2/projects/<project-id>/backups/<backup-id>/download/" \
  -o backup.zip

The list response also carries the schedule. nextBackupAt is when the next run starts, not when the file is ready:

{
  "isActive": true,
  "frequencyDays": 1,
  "retentionDays": 14,
  "nextBackupAt": "2026-08-11T03:17:00Z",
  "backups": []
}

View backup API endpoints

---

Availability

Automatic backups are part of every paid plan, including trials. On the Free plan the section shows an upgrade prompt instead of a list.

Draft projects - the temporary copies created while cloning or importing a project - are not backed up. They become eligible once the project itself is created.

---

Frequently asked questions

Can I trigger a backup manually?

No. Use Export as ZIP in project settings when you want a copy right away. The file is identical, BugBug just does not keep a copy of it for you.

Do backups count towards any storage limit?

No.

Does restoring a backup undo changes in my current project?

No. A restore creates a separate project and leaves the original untouched.

Is a backup taken if nothing changed that day?

Yes. Every eligible project gets its daily backup regardless of activity.

What happens to my backups when I downgrade to Free?

New backups stop being created, and the section is replaced by an upgrade prompt. Download anything you still need before the change.