site-builder/ERROR_153_INFO.md

# YouTube Error 153 - What It Means & Solutions

## What is Error 153?

YouTube Error 153 means: **"The owner of the requested video does not allow it to be played in embedded players."**

This is NOT a bug in the site builder - it's a restriction set by the video owner.

---

## What We've Fixed

✅ **Removed autoplay from URL parameters**
- Before: `?autoplay=1&mute=1&loop=1...`
- After: `?mute=1&loop=1...` (no autoplay)

✅ **Removed autoplay from iframe allow attribute**
- Before: `allow="accelerometer; autoplay; clipboard-write..."`
- After: `allow="accelerometer; clipboard-write..."` (no autoplay)

---

## Why You Might Still See Error 153

Some video owners have **completely disabled embedding**, not just autoplay embedding. This means:

- ❌ Video cannot be embedded anywhere (not just our site builder)
- ❌ Works on YouTube.com but not on external sites
- ❌ No workaround exists (video owner's choice)

### Video: OC7sNfNuTNU

The specific video you tested (`https://www.youtube.com/watch?v=OC7sNfNuTNU`) appears to have strict embedding restrictions set by the owner.

**This is normal and expected for some videos.**

---

## Test Videos That WILL Work

Try these videos - they have embedding enabled:

### 1. Never Gonna Give You Up (Rick Astley)
```
https://www.youtube.com/watch?v=dQw4w9WgXcQ
```
✅ Embedding: Enabled
✅ Known to work

### 2. Me at the zoo (First YouTube video)
```
https://www.youtube.com/watch?v=jNQXAC9IVRw
```
✅ Embedding: Enabled
✅ Historical video, always works

### 3. Big Buck Bunny (Open source film)
```
https://www.youtube.com/watch?v=YE7VzlLtp-4
```
✅ Embedding: Enabled
✅ Open source, no restrictions

### 4. Direct Video File (Guaranteed to work)
```
https://www.w3schools.com/html/mov_bbb.mp4
```
✅ No restrictions (direct file)
✅ Always works

---

## How to Check If a Video Allows Embedding

### Method 1: Look for Error 153
1. Try to embed the video
2. If you see Error 153 → embedding disabled by owner
3. Try a different video

### Method 2: Check YouTube Share Settings
1. Go to the video on YouTube.com
2. Click "Share" button
3. Look for "Embed" option
4. If "Embed" is greyed out → embedding disabled
5. If you can click "Embed" → embedding enabled (but might still have restrictions)

### Method 3: Try the Embed Code
1. Click "Share" → "Embed"
2. Copy the embed code
3. If it works in a plain HTML file → should work in site builder
4. If it shows Error 153 in plain HTML → video has restrictions

---

## Solutions & Workarounds

### Solution 1: Use a Different Video ✅ RECOMMENDED
- Choose videos with embedding enabled
- Test videos (like the ones above) are always safe
- Public domain / Creative Commons videos usually allow embedding

### Solution 2: Use Your Own Video Hosting
- Upload video to Vimeo (usually allows embedding)
- Use direct .mp4 file hosted on your server
- No restrictions when you own the video

### Solution 3: Contact Video Owner
- If you must use a specific video
- Ask the owner to enable embedding
- They can change this in YouTube Studio settings

### Solution 4: Use a Thumbnail + Link
- Take a screenshot of the video
- Use as background image instead
- Add a "Watch Video" button linking to YouTube

---

## For Content Creators: How to Enable Embedding

If you're the video owner and want to allow embedding:

1. Go to **YouTube Studio**
2. Select your **video**
3. Click **"Visibility"** or **"Advanced settings"**
4. Find **"Allow embedding"** checkbox
5. ✅ **Enable it**
6. Save changes

---

## Testing the Fix

### What to Test:

1. ✅ Add Section (Video BG)
2. ✅ Enter a test video URL: `https://www.youtube.com/watch?v=dQw4w9WgXcQ`
3. ✅ Click "Apply Video" button
4. ✅ Video should load without Error 153
5. ✅ No autoplay parameters in the embed URL

### Expected Result:

```
Embed URL should be:
https://www.youtube.com/embed/dQw4w9WgXcQ?mute=1&loop=1&playlist=dQw4w9WgXcQ&rel=0

✅ No autoplay=1
✅ Should work for most videos
❌ Will still fail for videos with embedding disabled
```

---

## Summary

**Error 153 = Video owner disabled embedding**

✅ **We fixed:** Removed autoplay to avoid autoplay-related Error 153
❌ **Can't fix:** Videos that have ALL embedding disabled by owner
✨ **Solution:** Use test videos above or your own videos

**This is not a bug - it's YouTube's content protection working as designed.**

---

## New Features Added (2026-02-22)

1. ✅ **Apply Video Button** - Click to load video (no need to press Enter)
2. ✅ **Removed autoplay from iframe allow attribute** - Further Error 153 prevention
3. ✅ **Better error messages** - Alerts explain if video fails to load

---

**Next Steps:**

1. Try the test videos above
2. If they work → Error 153 is just that specific video
3. If they don't work → check browser console for other errors
4. Report back with results!