---
url: /integrations/cloudflare-stream.md
description: >-
  Connect Cloudflare Stream to RootWright LMS Pro: enter the account ID, a
  Stream API token and the customer subdomain, switch the provider on, then
  upload lesson videos.
---

# How to connect Cloudflare Stream in RootWright LMS

Cloudflare Stream hosts lesson videos for RootWright LMS Pro. You upload a video from the lesson builder, Cloudflare encodes it, and students watch it in Cloudflare's player inside the lesson.

::: pro
Cloudflare Stream is a video provider in RootWright LMS Pro.
:::

## Before you start

* A Cloudflare account with **Stream** enabled.
* Your **Account ID**, shown on the Stream page of the Cloudflare dashboard.
* An **API token** with **Stream:Read** and **Stream:Edit** for this account. Create it at `dash.cloudflare.com/profile/api-tokens`. Use a scoped token, not the Global API Key.
* Your **customer subdomain**, for example `customer-a1b2c3d4.cloudflarestream.com`. Cloudflare shows it in any video's embed code.

## Connection fields

| Field | Required | What it does |
|---|---|---|
| **Account ID** | Yes | Identifies your Cloudflare account. |
| **API Token** | Yes | Lets RootWright LMS upload and read videos. Limit it to Stream:Read and Stream:Edit. |
| **Customer Subdomain** | Yes | The playback hostname. Students play videos from this address. Without it, a video can be picked and never played. |
| **Upload as signed-URL only** | No | Off by default. When on, new uploads play only with a signed token. See the warning below. |

## Connect Cloudflare Stream

::: steps

1. In WordPress, go to **Settings → Integrations → Video & storage**.
2. On the **Cloudflare Stream** card, click the edit icon.
3. In **Cloudflare Stream settings**, enter the **Account ID**, the **API Token** and the **Customer Subdomain**.
4. Leave **Upload as signed-URL only** off unless you have set up signing keys.
5. Click **Save**.
6. Switch on the **Cloudflare Stream** card.
   :::

![The Stream providers screen with Cloudflare Stream configured and switched on](/images/integrations/video-storage-02-providers.jpg)

*Settings → Integrations → Video & storage. The Cloudflare Stream card shows **Configured** once the settings are saved. Switch it on to use it.*

The settings form has no **Test connection** button. To check the setup, upload a short test video in a lesson.

## Upload a lesson video

::: steps

1. Open the lesson in the lesson builder and choose the **Video with Caption** lesson type.
2. Upload a file, or pick a video that already exists in the video picker.
3. Wait for the video to finish encoding. The picker shows the video as not ready until Cloudflare has encoded it.
   :::

::: todo Screenshot to add
**What:** The video picker in a **Video with Caption** lesson with a Cloudflare Stream video listed.

**How to get there:** Open a **Video with Caption** lesson in the lesson builder and open the video picker after uploading one short test video.

**Save as:** `docs/public/images/integrations/cloudflare-stream-02-video-picker.jpg` (1440×900 window, JPG)

**Then:** replace this box with:
`![The video picker with a Cloudflare Stream video listed](/images/integrations/cloudflare-stream-02-video-picker.jpg)`
:::

Cloudflare uploads go in a single request. The file is limited by PHP's upload limit on your host. For larger videos, use [Bunny.net](/integrations/bunny-stream), which uploads in chunks.

For the accepted formats and the other upload settings, see [Video & storage](/integrations/video-storage).

::: warning Signed URLs
Turn on **Upload as signed-URL only** only if you have set up signing keys in Cloudflare. A video that requires a signed URL does not play in the lesson player unless it is signed.
:::

## Messages you may see

When Cloudflare returns its own error message, RootWright LMS shows that message instead.

* **"Cloudflare rejected the token (401) — check that it has Stream:Read and Stream:Edit on this account."** Create a new API token with those two permissions, and enter it again. The number is the status Cloudflare returned, and a 403 shows the same message with 403.
* **"Not found (404) — check the account ID, or the video no longer exists."** Check the **Account ID**. If the message is about a video, the video may have been deleted in Cloudflare.
* **"Cloudflare returned status …"** Cloudflare returned an error that has no message of its own. Try again, and check the **Account ID** and the API token.
* **"Cloudflare accepted the upload but returned no video id."** Try the upload again.

## Related

* [Video & storage](/integrations/video-storage) for upload limits, watermarks and the other providers.
* [Bunny.net Stream](/integrations/bunny-stream) and [YouTube](/integrations/youtube) for the other video providers.