---
title: Troubleshooting
description: "This guide covers the most common questions and problems. ## A video is still \"queued\" Possible reasons: - Cloudflare Stream has accepted the upload but has not finished processing yet - a follow-up sync job has not run yet -…"
url: "https://handyplugins.co/docs/stream-integration-pro-troubleshooting/"
updated: "2026-04-13"
category: Stream Integration Pro
---

# Troubleshooting

This guide covers the most common questions and problems.

## A video is still "queued"

Possible reasons:

- Cloudflare Stream has accepted the upload but has not finished processing yet
- a follow-up sync job has not run yet
- the video is not ready to stream yet

What to do:

1. Open the attachment details screen.
2. Check the Stream status.
3. Use `Sync Stream Data` if needed.
4. Refresh the attachment after a short wait.

## The preview shows a thumbnail instead of a player

This usually means the Stream video is not ready yet or the player cannot currently load the Stream source.

This is expected while a video is still:

- queued
- uploading
- processing

Once the video is ready, the preview should switch back to the embedded player.

## I uploaded a video but it stayed local-only

Check:

- `Auto-import newly uploaded WordPress videos` is enabled
- the file is a supported video upload
- the queue is running normally
- credentials are valid

If needed, open the attachment and use `Upload to Stream`.

## A custom poster image does not render in local development

If the player is loaded from a Cloudflare iframe and your poster image is served from a local `.test`, `localhost`, or similar development domain, browser security rules may block it.

In that case:

- use `Thumbnail time (seconds)` instead
- or test the custom poster on a public production-like domain

## "Delete from Stream" or other media actions fail with 403

Common reasons:

- an expired REST nonce
- an old browser tab
- a stale admin session

What to do:

- refresh the page
- if needed, log out and back in

## Queue history is empty

That can be normal.

If `Enable detailed queue diagnostics` is disabled:

- completed and failed queue history is not retained
- only active queue work is relevant

## The plugin was uninstalled but my videos still exist

That is intentional.

Even when uninstall cleanup is enabled, Stream Integration Pro does not automatically delete:

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

The uninstall cleanup only removes plugin-owned integration data.

## Licensing problems

If licensing fails:

- verify the key is correct
- check whether it has expired
- make sure the current site or network URL matches your license policy

For more detail:

- License and Updates

## Still Stuck

When you need more context, collect:

- the attachment ID
- the Stream UID
- the current storage state
- the exact queue state
- the exact error message

Then reproduce the problem with one test video so you can isolate whether the issue is:

- local upload
- direct Stream upload
- queue processing
- preview rendering
- licensing