Fix YouTube chapters that do not show

What to do

Check the first timestamp, ordering, number of entries and duration of each chapter. Save the description and revisit the watch page.

Find the first failing condition

Check the first line, the number of entries, time order, and segment duration. Remove duplicate times and inspect the actual final runtime. Save the corrected description and reopen the watch page. If the list is well formed and still missing, review the platform's current eligibility guidance for your video or account. Save a copy of the final list so you can compare it against a future edit.

Example or check

A duplicated time can cause a formatting failure. Correct the list before investigating account or video eligibility.

Related checks for sharing, embedding and chapters

Keep chapter starts useful

Start the first manual chapter at zero and put the others in increasing order. Give each segment a label that explains what begins there. Check current YouTube rules for number and duration before publishing; a list that looks readable in a description may not qualify as chapters. Review each time against the actual cut, including the final segment, since the editor's timeline and uploaded version can differ after trimming. The first chapter should name what a viewer sees from the start, while later chapters should point to real changes in task or explanation rather than arbitrary intervals.

Work from a timestamp you can verify

For a tutorial segment, stop just before the relevant instruction and record the time shown by the player. Convert minutes and seconds to total seconds when a URL or embed field asks for seconds. For instance, one minute and thirty-five seconds is ninety-five seconds. Be clear whether you are pointing to the first meaningful word or the first useful frame. Leave enough lead-in that the viewer can see the context. If the creator edits the video later, revisit time links used in documentation, since a trim can move the event you were referencing.

Isolate an embedded playback failure

First verify that the video opens at its original watch URL for the intended viewer. Then test another embeddable video inside the same page layout. If the second video plays, investigate restrictions or availability for the first video. If neither plays, check whether the CMS strips iframe markup, whether a site policy blocks the frame, or whether a privacy or browser setting is preventing playback. Compare the browser's rendered page with the editor view. Do not treat a working creator account as proof that a guest has access to a private upload.

Know where an embed ends and a page begins

An embed plays a video inside your site, but the outer page still needs to explain why the video is there and offer an accessible way to use the material. Add a short summary, any essential written instructions, and the direct link when useful. Test both keyboard navigation and playback after publishing. On a site builder, saving a code block may sanitize attributes that worked in a local file. If the player looks cropped, inspect the iframe dimensions and its parent container before modifying the video itself. Keep a working fallback for readers who cannot load the player.

Identify which link you actually need

A single video, a playlist, a particular playback time, and an iframe are different destinations. A video ID identifies one upload. Extra URL parameters can carry the time or playlist context. Removing every parameter may be correct when you want a clean watch link but wrong when you are sending the exact moment of a lesson. Keep the original link as a reference, then generate the intended version. Test it in a fresh tab rather than trusting a copy operation alone. The same video can open in a different interface depending on whether the link is a watch URL or a Shorts URL.

Keep accessibility in the embed

Give an iframe a useful title so a reader using assistive technology knows what video it contains. Put explanatory text or a direct watch link nearby when the surrounding page needs to remain useful without the player. Test the embed at a narrow screen width and verify the player controls remain reachable. A responsive aspect-ratio box is easier to maintain than one hardcoded width for every screen. If the video is optional, lazy loading can reduce the initial work of opening the page; for a privacy-sensitive site, choose the approach that matches your consent setup and documented practices.

Test a link as its recipient

Open the URL in a browser session or account that reflects the recipient's access. If you sent a time link, check that it opens near the intended moment and that playback can proceed. For a shared video inside a private workspace, distinguish a link that opens the right page from permission to view the video. For public documentation, keep a plain watch link available if an embedded player fails. If a link is for a series, check whether the playlist opens at the intended lesson. Confirm on a phone when that is where people are likely to use it.

Write the label next to the link

A link labeled with an action or topic is more useful than one labeled click here. Tell the reader if it starts at an exact moment, opens a playlist, or leaves the current page. For multiple links to the same video, name the distinct sections rather than repeating the title with different timestamps. Keep the visible label independent of URL syntax so you can update the destination after an edit. In a description or help page, a concise label also makes it possible to check your links in order without opening each one to discover why it was included.

Preserve a record before rewriting links

Keep a note of the raw share URL and the version you published. If you intentionally remove tracking, time, or playlist parameters, note what behavior changes. A copied link from a social app may contain extra text as well as a URL; extract the URL before assuming it is malformed. Verify the actual video ID instead of trusting a similar title. In an article that points to several clips, keep a small list of original IDs and their purposes so a link can be repaired without searching by title again.

Keep an example that can be re-tested

Save a short example with the input address, the intended behavior, and the final link or code. The record is useful when a platform changes how a link opens on a particular device. For a time link, record the intended frame as well as the seconds. For a chapter list, note the video version. For an embed, include the page that hosts it and one browser where it played. When something stops working, test that saved example first. This distinguishes a changed link from a wider problem with the page or player.