You can delete a single backup by hand, at every target where it is stored and from the list. Before that, the plugin asks for confirmation and warns if it is the last valid backup at a target.
Deleted is deleted
The plugin deletes the files of the backup at the targets and removes the backup from the list.
Step 1: Choose Delete
Open the Backup page. In the Backups list, click More … in the row of the backup, then Delete backup. The Recent backups tile on the Overview page has the same menu.
- Restore takes you to the page where you restore the backup.
- Check backup checks whether the backup is readable and complete.
- Lock backup protects the backup from deletion.
- Download only appears for a backup that is stored at a local target.
- Log opens the log of the backup.
- Delete backup is in red at the end of the menu and opens the confirmation prompt.
Step 2: Read the confirmation prompt
- The text shows the date of the backup and the targets where it will be deleted.
- Cancel closes the confirmation prompt without deleting anything.
- Delete starts the deletion.
The confirmation prompt has the title Delete backup? and says: The backup from … is deleted at … and disappears from the list. If the backup is no longer stored at any target, it says: The entry from … is removed from the list. There is no backup for this entry at any target.
When it opens, the plugin checks at every target of the backup whether the backup is still stored there. While it is checking, the confirmation prompt reads Checking the targets …, and Delete cannot be clicked yet. If the check fails, it reads in red The targets could not be checked: … Deleting stays locked until the check succeeds. Check again repeats it.
The last valid backup at a target
If no other valid backup would remain at a target of the backup, the confirmation prompt warns in red. You can still delete it.
- Attention! This is the last valid backup of this website at this target. After it there is none.
- Delete remains possible.
If this applies to several targets, the warning lists them: Attention! This is the last valid backup of this website at these targets: …. After it there is none there.
A locked backup
A locked backup cannot be deleted. The confirmation prompt says so and offers only Cancel.
- This backup is locked. Unlock it first; then it can be deleted.
- Cancel
In the menu of the backup, choose Unlock backup first, then Delete backup.
A target no longer has the backup, does not answer or was removed
If a target no longer has the backup, does not answer or was removed, the confirmation prompt shows this target in a red line. Only then does it also show a checkbox. In the picture, the backup is stored at two targets, and one of them does not answer.
- The red line shows the target that does not answer.
- Only remove the entry from the list; nothing is deleted at the targets. is a checkbox.
- Cancel closes the confirmation prompt without deleting anything.
- Delete deletes the backup at its targets; with the checkbox ticked, only the entry.
| Red line | What it means |
|---|---|
| At “…” the backup no longer exists. | The target answers, but the backup is no longer stored there, for example because its files were deleted by hand. |
| The target “…” does not answer. | The plugin cannot reach the target: the target does not answer, or the login fails. |
| The target “…” was removed. | The target was removed: it is no longer set up on the Targets page. The plugin no longer has access to it. |
The checkbox is meant for a backup that no longer exists at its targets. If there is a red line for every target of the backup, the checkbox is already ticked when the confirmation prompt opens. Otherwise it is not ticked. If every target still has the backup, there is no checkbox.
- With the checkbox ticked, the entry disappears from the list immediately after Delete, without a job. The page reports Entry removed. The plugin deletes nothing at the targets: files of the backup that are still stored at a target stay there.
- Without the checkbox, the deletion runs as in steps 3 and 4. A file that is already missing at the target counts as deleted. At a target that was removed, the plugin deletes nothing: in the list, the backup only loses the reference to this target. If a target still does not answer during the deletion, the deletion fails there, and the backup stays in the list with this target. If the backup has been deleted at another target, the page reports The backup could not be deleted at every target. See the log., otherwise The backup could not be deleted. See the log.
If you removed only the entry with the checkbox and the backup is still stored at a target, the plugin finds it there again as soon as it checks this target. The plugin checks when you save the target on the Targets page and the connection test succeeds, and when you choose Find backups at this target in the menu of this target. It then adds the backup to the list again on its own. If it shows the tile Backups found at “…” instead, the backup is added to the list only after Add them to the list. Afterwards the Plan column shows reclaimed. The backup then no longer belongs to any plan, and the plugin never deletes it automatically. More on this: Find backups again after a reinstallation, section “Other cases”.
Step 3: Follow the progress
The deletion runs as a job in steps, like a backup. While it runs, the Backup tile shows the progress.
- The progress begins with Deleting backup. The completed entries follow, one entry per target of the backup, and then the remaining time.
- Abort deletion aborts the deletion.
Aborting undoes nothing: what the plugin has deleted up to that point stays deleted. After an abort, the message at the end is red; more on this under “If something does not work”.
Step 4: Read the result
At the end, a message appears.
- Backup deleted.
The backup is no longer in the list.
If the backup was stored at a target that has been removed in the meantime, the message adds a sentence: At a removed target one entry was taken from the list only; nothing was deleted there. With several removed targets it reads: At removed targets … entries were taken from the list only; nothing was deleted there.
If the deletion failed at a target or you aborted it, the message is red, and the backup may still be in the list: see “If something does not work”.
Deleting a failed or aborted backup
A failed or aborted backup has no copy at any target. Instead of Delete backup, its menu offers the entry Delete entry.
- Log opens the log of the backup.
- Delete entry opens the confirmation prompt.
- Delete entry? is the title of the confirmation prompt.
- The text says that there is no backup behind the entry. Only the row disappears from the list.
- Delete removes the entry immediately, without a job.
Afterwards the page reports Entry removed.
If something does not work
If the deletion fails at a target, the red message shows the target and the cause.
- The backup could not be deleted. See the log.
- The line shows the target where the deletion failed, and the cause.
- Below it is the original message; for an SFTP target, the message of the SSH library.
- Log opens the log of the deletion.
The first sentence of the red message 1 says how far the deletion got. It exists in two versions; the table lists both. The plugin does not repeat a manual deletion on its own.
| Message | What you can do |
|---|---|
| A job is already running. | Wait until the running job has finished, then delete again. |
| The backup could not be deleted. See the log. | The plugin did not delete the backup at any target, for example because the target could not be reached, or the deletion was aborted or ended with an error. What was deleted before an abort stays deleted. Log in the message opens the log of the deletion; after a failed deletion it shows the target and the reason: Read the log. If the backup is still in the list, delete it again later. If the target has stopped answering for good, you remove the entry with the checkbox of the confirmation prompt: see “A target no longer has the backup, does not answer or was removed” under step 2. |
| The backup could not be deleted at every target. See the log. | The plugin deleted the backup at one or more targets, but not at one or more others. The backup stays in the list, but only with the targets at which it was not deleted. Log in the message opens the log of the deletion; it shows the target and the reason. Delete the backup again later: the confirmation prompt then lists only the remaining targets. If a target has stopped answering for good, you remove the entry with the checkbox of the confirmation prompt. |
| Every target still has this backup. Delete it the normal way. | You ticked the checkbox, but in the meantime every target answers and has the backup. The plugin then does not remove the entry. Delete the backup without the checkbox. |
| A backup was locked meanwhile and stays. | The backup was locked while the deletion was running. The message is yellow. Unlock it and then delete again. |
Good to know
- Deleting in the browser always applies to all targets of the backup: you cannot select individual targets there. Deleting at a single target is only possible on the command line.
- If the folder at a target belongs to another installation (the plugin reads this from the catalog that is stored there next to the backups), the plugin deletes nothing there. For the message, this target counts like a target at which the deletion failed: The website has moved or is a copy.
- The log of the backup stays for as long as logs are kept. You then find it in the download of all logs.
- You do not have to delete old backups by hand: after every valid backup, the plugin itself removes what exceeds Max. backups.
See also
- Define how many backups are kept
- Protect a backup from deletion
- PRODelete several backups at once
- Remove a target
- The “Backup” page
- Create and manage backups with WP-CLI
On the command line
WP-CLI not set up yet? How to install WP-CLI.
WP-CLI also asks before deleting; --yes skips the question. With --target you delete the backup only at the target you specify. With --entry-only the command only removes the entry from the list and deletes nothing at the targets; this works only as long as at least one target no longer has the backup, does not answer or was removed. The command refuses a locked backup.
# Show backups with job name, status and targets wp cloneworx-backup backup list # Delete a backup at all its targets wp cloneworx-backup backup delete <Job> # Delete only the copy at one target, without confirmation prompt wp cloneworx-backup backup delete <Job> --target=local-1 --yes # Remove only the entry, delete nothing at the targets wp cloneworx-backup backup delete <Job> --entry-only