---
title: Restore
description: Restore your VirtualDJ files from a previous backup when an import needs rolling back.
url: "https://vdjtools.com/docs/restore/"
updated: "2026-10-28"
category: "Feature Guide / Backup & Restore"
tags:
  - recovery
  - restore
  - safety
---

# Restore

Restore brings your VirtualDJ databases, folders, playlists, and history back to a previous backup.

## When to use it

When an import went wrong, a workbook decision needs rolling back, or you just want to get back to a known-good state quickly.

## What it does

It restores your backed-up VirtualDJ files — it doesn't repair individual rows the way a repair page does. It's a full return to an earlier point in time.

## Key arguments

- `/restore`
- `/list`, `/all`, `/file:<filename>`
- `/include:<types>`, `/pageLength:<n>`

## Example commands

```
vdjtools /restore /list
vdjtools /restore /all
```

## Typical workflow

List your available backups, narrow the restore scope if you only need part of it back, confirm the overwrite, then run a Healthcheck to confirm you're back on solid ground.

## Safety notes

If an import goes wrong, restore is almost always the cleaner answer — rather than layering more fixes on top of a bad result.

## Limitations

Restore rolls back to the backup's point in time, so any good changes made after that backup get rolled back too.

## Common scenario

A wrong path proposal slipped through validation. Rather than trying to patch it live, you restore, correct the workbook properly, and re-run the import.

## Related pages

- Backup
- Understanding the Workbook