So you've got a video on YouTube. You've got a WordPress site. Now you want the two to work together, and you want the video to actually help people find you.
Here's the thing most people miss: the video alone won't do much. What makes it work is the text around it. That's what search engines and AI tools can read.
This guide walks you through the whole thing. How to embed the video, how to get a clean transcript, how to mark it up properly, and how to check whether any of it is paying off. No coding degree required.
TL;DR Paste a YouTube link on its own line in the WordPress block editor and it turns into an embed automatically. Use an iframe or a plugin when you need more control. AI tools don't watch video. They read text. A transcript is how your video becomes something they can actually use. The workflow is simple: embed the video, grab the captions from YouTube Studio, clean them up, paste them under the video, and add VideoObject schema. A transcript improves your chances of being quoted or cited. It does not guarantee a ranking. Anyone who promises that is guessing. Semly shows you whether AI tools are citing your content at all, so you can tell if the work is landing.
Embedding YouTube Videos in WordPress — the simple way
Let's start with the fastest route.
Open your post in the WordPress block editor. Add a new block. Paste your YouTube link. That's it.
WordPress uses something called oEmbed. When you paste a YouTube URL on its own line, WordPress recognizes it and swaps it for a player. No code, no settings, no plugin.
There's one catch, and it trips up a lot of people. The link has to sit on its own line. If you paste it in the middle of a sentence, WordPress treats it as plain text and you get a clickable link instead of a video. That's the number one reason embeds "don't work."
If you want a bit more control, you have options:
- YouTube block or oEmbed — the default. Best when you just want the video on the page, fast.
- Custom HTML block with an iframe — best when you need to control parameters like autoplay, start time, or related videos.
- A plugin like Embed Plus for YouTube or Smash Balloon — best when you have lots of videos, want galleries, or need lazy loading built in.
That's really the whole decision. Everything else is detail.
Which embed method fits your case
Here's a quick way to pick.
- Choose the block or oEmbed if you're adding one or two videos and you want it done in ten seconds.
- Choose an iframe in a Custom HTML block if you need specific parameters, like starting the video at a certain moment or hiding suggested videos at the end.
- Choose a plugin if you're running a video-heavy site, want a gallery layout, or care about page speed and lazy loading.
If you're not sure, start with the block. You can always swap it later.
A quick note on what to watch for: don't paste the link inside a paragraph. Give it its own line. And check the embed on mobile, because that's where most of your readers will see it.
Why transcripts matter for SEO and AI search
Now the part that actually moves the needle.
AI tools don't watch your video. They can't. They read text. So if your video's content only exists as audio and moving pictures, there's nothing for them to work with.
A transcript changes that. It turns your video into text on a page. Text can be crawled, indexed, and quoted. That's the whole game.
There's a second piece too. Google needs the page where your video lives to be indexed and performing before the video itself even gets considered. So the page matters as much as the video. A transcript gives that page real substance.
Then there's structured data. Adding VideoObject markup tells search engines what your video is, what it's about, and where to find it. It makes your video eligible for certain treatments. It does not guarantee you'll get them.
Let's be clear about one thing, because it's where a lot of advice goes wrong:
- A transcript helps your content get found and quoted. That's a real benefit.
- A transcript does not equal a higher ranking. Nobody can promise that.
If you see a claim that transcripts boost rankings by some huge number, treat it as a hint, not proof. The honest version is that transcripts make your content readable, and readable content has a better shot at being cited.
For context, Semly's own guidance notes that AI models can't watch video but do read transcripts, and that YouTube shows up in a meaningful share of Google AI Overviews. That's a directional signal, not a guarantee.
Step-by-step: add a transcript to your WordPress video
Here's the full sequence. Follow it in order and you'll be fine.
Step 1: Make sure your video has captions. Go to YouTube Studio, open your video, and head to Subtitles. If there are no captions, use "Duplicate and Edit" to create them. Auto-generated captions are a fine starting point. Checkpoint: your video has a caption track you can copy text from.
Step 2: Copy the caption text into your editor. Grab the text and paste it somewhere you can work with it. Strip out the timestamps and the repeated lines. Auto-captions love to repeat. Checkpoint: you have a wall of plain text with no timecodes.
Step 3: Fix the errors. Auto-captions mangle names, brands, and industry terms. Read through and correct them. This matters more than you'd think, because a wrong name is a name search engines won't connect to you. Checkpoint: every proper noun is spelled correctly.
Step 4: Put the transcript on the page. Add it below the video. You can use a simple paragraph block, a "Transcript" heading with the text underneath, or break it into question-based sections if your video answers specific questions. Checkpoint: the transcript is visible on the page, not hidden in a collapsed element nobody opens.
Step 5: Add VideoObject schema. This is the technical bit, and it's easier than it sounds. More on it below. Checkpoint: the markup validates without errors.
Step 6: Check whether it's working. Validate your structured data, then watch whether AI tools start citing your content. That second part is where most people stop guessing and start measuring. Checkpoint: you have a way to see citations, not just a hope.
Getting a clean transcript (and fixing auto-captions)
Quality here is everything. A messy transcript with timecodes and garbled words is barely better than no transcript.
Here's what to fix, every time:
- Remove timestamps and speaker labels you don't need.
- Delete repeated words and false starts.
- Correct names of people, brands, and products.
- Fix industry terms the auto-caption got wrong.
- Break the wall of text into paragraphs.
- Add question-based subheadings if the video covers several topics.
That last point is worth a moment. If your video answers "how do I embed a YouTube video in WordPress," make that a heading in your transcript. Headings help readers skim and help machines understand structure.
Adding VideoObject schema (without breaking your page)
VideoObject is a structured data type. You describe your video in a format search engines understand.
The key properties are:
name— the video titledescription— a short summarythumbnailUrl— the preview imageuploadDate— when it went livecontentUrlorembedUrl— where the video livestranscript— the text of your video
You add this as JSON-LD, usually in a Custom HTML block or through your theme's header. Then you validate it with Google's Rich Results Test.
One honest note: adding VideoObject doesn't mean you'll get a video rich result. It makes you eligible. Eligibility and placement are two different things.
Common mistakes and how to fix them
Here are the ones I see most often.
- Link pasted inside a sentence. Symptom: you get a plain link, not a player. Fix: put the URL on its own line.
- Transcript full of timecodes. Symptom: unreadable text that looks like a subtitle file. Fix: strip the timestamps before pasting.
- No transcript on a talking-head video. Symptom: a page with almost no indexable text. Fix: add the transcript. If there's speech, there should be text.
- VideoObject missing required fields. Symptom: validation errors. Fix: include name, description, thumbnailUrl, and uploadDate at minimum.
- The same transcript duplicated across pages. Symptom: thin, repetitive content. Fix: keep one transcript per video, on the page where the video lives.
- Never checking if the page is indexed. Symptom: you did all the work and nothing happens. Fix: confirm the page is indexed before expecting anything from the video.
What to do next
Once the basics are in place, here's where to go.
- Add chapters based on questions. If your video answers several questions, turn them into chapters on YouTube and headings in your transcript. It helps viewers and it helps machines.
- Do this for every video. One transcript is a start. A library of them builds real topical depth.
- Check which AI models cite you. This is the part most people skip. You can't improve what you don't measure.
- Consider your hosting setup. If you want full control over the player and the data, self-hosting video is an option. For most people, YouTube plus a good transcript is the practical choice.
Quick decision tree:
- If you have one video and limited time, do the embed and the transcript. Skip the rest for now.
- If you have a video library, add transcripts across the board and consider a plugin for galleries.
- If you want to know whether any of it works, start tracking citations.
How Semly helps you track the results
Here's the gap in most guides. They tell you to add a transcript and then leave you wondering whether it did anything.
Semly closes that gap. It's a platform built for AI visibility, and it monitors how your brand shows up in answers from ChatGPT, Gemini, Claude, Google AI, and Grok.
That means you can see your Citation Rate, which is how often AI tools actually reference your content. You can see which sources the models are pulling from. And you can see whether your videos and transcripts are part of that picture.
Semly also integrates with WordPress and WooCommerce, so if your site runs on either, you can connect it and start monitoring without rebuilding anything.
The point isn't to chase a number. It's to stop guessing. You add the transcript, you embed the video, and then you check whether AI tools are picking it up. If they are, you do more of it. If they aren't, you adjust.
That's a much better position than hoping.
Mini glossary
- oEmbed — the standard that lets WordPress turn a pasted link into an embedded player automatically.
- VideoObject — a structured data type that describes a video to search engines.
- Transcript — the written text of your video's spoken content.
- Citation Rate — how often AI tools reference your content in their answers. Semly tracks this for you.
Before you publish: a quick checklist
- The YouTube link sits on its own line and shows up as a player.
- The embed looks right on mobile.
- The video has captions in YouTube Studio.
- The transcript is cleaned up, with no timecodes or repeats.
- Names and industry terms are spelled correctly.
- The transcript is visible on the page, under the video.
- VideoObject schema is in place and validates.
- The page is indexed.
- You have a way to check whether AI tools cite you.
Work through that list once and you'll be ahead of most sites out there. Then do it again for the next video.