Popular Search shortcodehookemailtheredirect
View Categories

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:

Was this guide helpful for you?