---
title: Tools and Cleanup
description: "The `Tools` tab is where you manage background jobs, retained diagnostics, and destructive cleanup workflows. ## Operations and Queue This section helps you understand background work such as: - auto-import jobs - Stream metadata sync jobs - local restore jobs…"
url: "https://handyplugins.co/docs/stream-integration-pro-tools-and-cleanup/"
updated: "2026-04-13"
category: Stream Integration Pro
---

# Tools and Cleanup

The `Tools` tab is where you manage background jobs, retained diagnostics, and destructive cleanup workflows.

## Operations and Queue

This section helps you understand background work such as:

- auto-import jobs
- Stream metadata sync jobs
- local restore jobs
- local cleanup jobs

### Enable detailed queue diagnostics

When enabled:

- recent completed and failed queue history is retained
- recent history becomes visible in the UI
- failed jobs can be reviewed and retried more easily

When disabled:

- finished queue history is not retained
- the UI stays quieter
- only active work is relevant

### Queue history retention

These settings only matter when detailed diagnostics are enabled.

You can control:

- completed history retention in days
- failed history retention in days

### Clear queue history

This removes retained completed and failed history for Stream Integration Pro’s queue.

It does not:

- stop active jobs
- cancel running jobs
- delete WordPress media items

## Media Cleanup Danger Zone

This section is intentionally destructive.

Use it when you want to clean up storage in a controlled way.

### Available cleanup actions

- `Delete local files`
- `Delete Cloudflare Stream copies`

### Available target states

Depending on the action, you can target states such as:

- `Local + Stream`
- `Stream only`
- `Missing local file`

### Built-in safety checks

Before the cleanup runs, Stream Integration Pro shows:

- how many attachments match
- sample items
- a warning that explains what will happen
- a confirmation checkbox

The cleanup button stays disabled until you explicitly confirm the action.

## Recommended Cleanup Rules

### When to delete local files

Use this when:

- you trust Stream as the long-term storage location
- the videos are already confirmed ready in Cloudflare Stream
- you want to reduce local disk usage

### When to delete Stream copies

Use this when:

- you want to keep WordPress as the only storage location
- you are cleaning up imported or migrated Stream copies
- you understand some `Stream only` items may become removable if no local file exists

## Uninstall Cleanup Setting

The `Tools` tab also contains the uninstall cleanup preference.

If enabled, uninstall removes plugin data such as:

- plugin settings
- encrypted credentials
- saved license data
- retained queue history
- scheduled Stream Integration Pro jobs
- Stream Integration Pro attachment meta

It does not remove:

- WordPress media items
- local upload files
- Cloudflare Stream videos

For more detail:

- [Troubleshooting](https://handyplugins.co/docs/stream-integration-pro-troubleshooting/)
- [Multisite Guide](https://handyplugins.co/docs/stream-integration-pro-multisite-guide/)