Why your YouTube chapters aren't showing up (and the boring rules that fix it)

YouTube chapters have one deeply annoying property: when they don’t work, nothing tells you.

You paste your timestamps into the description, hit save, open the video, and the progress bar is one long unbroken line. No error message. No yellow banner in Studio. The description still shows your timestamps as clickable links, which makes it feel like it almost worked. It didn’t.

Nearly every time, the cause is one of a handful of rules that the parser enforces strictly and never explains. Here they are.

The four rules

For YouTube to turn your description timestamps into chapters, the list has to meet all of these:

1. The first timestamp must be 0:00. Not 0:01, not 0:05 because your intro has a second of black. Zero. 00:00 is fine too.
2. You need at least three timestamps. Two chapters isn’t a chapter list as far as YouTube is concerned.
3. Every chapter must be at least 10 seconds long. That includes the last one, measured to the end of the video.
4. Timestamps must go in ascending order. Each one later than the one before.

That’s the whole contract. Break any single rule and the entire list is ignored, not just the bad line.

The mistakes we see most

Knowing the rules is half of it. The other half is noticing you’ve broken one, which is harder than it sounds when you’re squinting at a description box at 1 a.m.

Starting at the first “real” moment

This is the big one. You’ve got a short cold open, so you write:

0:12 Why most budgets fail
2:40 The 50/30/20 problem
6:05 What to do instead

It looks reasonable. It’s dead on arrival. Add a 0:00 Intro line (or 0:00 Cold open, or whatever’s honest) and the whole thing comes back to life.

A sneaky short chapter

You recorded a 6-second sponsor bumper and gave it its own line:

0:00 Intro
1:30 Sponsor
1:36 Main tutorial

That middle chapter is six seconds. One short chapter kills the list. Fold the bumper into the chapter before or after it.

The last chapter catches people too. If your final timestamp is 14:58 Outro and the video is 15:03 long, that outro is five seconds and the list is invalid. Nothing in the description itself reveals that, because the video length isn’t written down anywhere, so check it against the actual runtime.

Copy-paste ordering bugs

You reorganized the edit, moved a segment, and updated most of the timestamps:

0:00 Setup
3:15 First test
2:50 Results

Out-of-order timestamps usually come from editing, not writing. They’re easy to miss because each line looks fine on its own.

Malformed times

1:5 instead of 1:05. 65:00 written as minutes on a video over an hour, where 1:05:00 is the safer form. A stray letter O where a zero should be. Seconds over 59. Each of these can stop a line from being read as a timestamp at all, and depending on where it falls, that can break the first-is-zero rule or the ordering rule.

Formatting that works reliably

YouTube is somewhat flexible about formatting, but the one that never gives us trouble is the plainest:

0:00 Intro
1:42 The setup
4:10 First attempt
9:35 What went wrong
13:20 Final result

Timestamp first, a space, then a title. One chapter per line. Nothing clever. Dashes and bullets before or after the timestamp usually work, but if your chapters aren’t appearing, stripping the list back to this format is a good first move.

Things the rules don’t cover

Even a perfect list can take a little while to show up after you save. Give it a few minutes and refresh before you start rewriting.

Studio also has an automatic chapters setting. If you’ve provided your own timestamps, those take priority. But if your list is invalid, YouTube may fall back to its own auto-generated chapters, which is why you sometimes see chapters you never wrote. That’s a sign your list broke, not that YouTube ignored it on purpose.

If your list follows every rule and chapters still won’t appear, work through our chapters troubleshooting guide. It covers invisible pasted characters, Shorts, and the other cases these four rules don’t explain.

Write good chapter titles while you’re here

Getting chapters to appear is the mechanical part. Getting people to use them is about titles.

A chapter list is a table of contents, but it’s also a second pitch for the video. Someone hovering over your progress bar is deciding whether to skip ahead or leave. “Part 2” gives them nothing. “Why the cheap tripod won” gives them a reason to stay.

A few habits that help:

• Name the payoff, not the segment. “Results” is a segment. “It ran 40% faster” is a payoff (assuming that’s true, of course).
• Keep them short. Chapter titles get truncated on the progress bar and in search. Front-load the important word.
• Don’t over-chapter. Twelve chapters in an eight-minute video is noise. Mark the moments where a viewer might reasonably want to jump.

Check before you publish

The cheapest fix is the one you make before the video goes live, while you still have the edit open and the timestamps fresh. Paste your list into the Chapter Validator and it’ll flag a missing 0:00, anything out of order, duplicates, and chapters under 10 seconds, then give you a cleanly formatted list to copy back. It runs entirely in your browser, so you can do this for a video that’s still private.

It can’t know how long your video is, though. That one’s on you: look at the last timestamp, look at the runtime, and make sure there are at least ten seconds between them.

Boring rules, quietly enforced. Once you know them, chapters just work.