---
title: Cloudflare Stream Settings Guide
description: "This page explains every settings tab and what each option changes. ## General Tab ![](data:image/gif;base64,R0lGODdhAQABAPAAAP///wAAACwAAAAAAQABAEACAkQBADs=) The `General` tab controls how the plugin connects to Cloudflare Stream and how local-first imports behave. ### Account ID Your Cloudflare Stream account ID. If…"
url: "https://handyplugins.co/docs/cloudflare-stream-settings-guide/"
updated: "2026-04-13"
category: Stream Integration Pro
---

# Cloudflare Stream Settings Guide

This page explains every settings tab and what each option changes.

## General Tab

![](data:image/gif;base64,R0lGODdhAQABAPAAAP///wAAACwAAAAAAQABAEACAkQBADs=)

The `General` tab controls how the plugin connects to Cloudflare Stream and how local-first imports behave.

### Account ID

Your Cloudflare Stream account ID.

If it is defined in `wp-config.php` as `SIP_CF_STREAM_ACCOUNT_ID`, the field is locked and managed from config.

### API Token

Your Cloudflare Stream API token.

If it is defined in `wp-config.php` as `SIP_CF_STREAM_API_TOKEN`, the field is locked and managed from config.

If you enter it in the admin UI, the plugin stores it encrypted in the database.

### Preferred media domain

Controls which Cloudflare playback domain is used for embeds and playback URLs.

Use this when:

- you have a preferred customer-specific media domain
- you need a specific domain for CSP or embed policy reasons

### Poster time (seconds)

Controls the default thumbnail time for videos when no block-level override is set.

This is the site-wide default used by:

- the block editor when a block is set to `Use global poster setting`
- frontend rendering when no custom poster or custom poster time is set

### Use signed playback URLs

When enabled, embeds use signed playback URLs.

Use this only if your Cloudflare Stream setup requires signed playback access.

### Signed URL TTL (minutes)

How long signed playback URLs remain valid.

## Local-First Import Settings

![](data:image/gif;base64,R0lGODdhAQABAPAAAP///wAAACwAAAAAAQABAEACAkQBADs=)

These settings apply to videos uploaded through the normal WordPress Media Library.

### Auto-import newly uploaded WordPress videos

When enabled, newly uploaded WordPress videos are automatically queued for upload to Cloudflare Stream.

This only applies to local WordPress uploads. It does not affect videos uploaded directly to Stream.

### Local file retention policy after successful import

Controls what happens after Cloudflare Stream has confirmed the video is ready.

Options:

- `Keep local files`
- `Delete local files after Stream is ready`

If you are unsure, use `Keep local files`.

## Tools Tab

![](data:image/gif;base64,R0lGODdhAQABAPAAAP///wAAACwAAAAAAQABAEACAkQBADs=)

The `Tools` tab covers queue diagnostics, cleanup tools, and uninstall behavior.

See:

- [Tools and Cleanup](https://handyplugins.co/docs/stream-integration-pro-tools-and-cleanup/)

## License Tab

The `License` tab is where you activate automatic updates.

See:

- [License and Updates](https://handyplugins.co/docs/stream-integration-pro-license-and-updates/)

## Saving Settings

Settings are saved with a normal WordPress form submit, not a custom AJAX save.

That means:

- you get the normal WordPress success notice
- the page reloads after save
- your latest saved state is shown immediately

## Notes for Multisite

If the plugin is network-activated:

- settings move to the network admin area
- credentials and license are shared across the network
- site-level Media Library workflows still happen inside each subsite

For more detail, read:

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