Skip to content

Your chapter list is in the description and nothing happened

Check why a music chapter list does not appear on YouTube: timestamp format, the 0:00 entry, chapter count, spacing and access to the chapter feature.

An entry at 0:00, at least three entries, ten seconds each: those are the rules, and a list can satisfy all three on paper and still do nothing. What follows is everything else, in the order worth ruling it out.

Drop your project or session file here

Ableton .als, FL Studio .flp, rekordbox .cue, Traktor .nml or Serato .session.

Your file is read in this browser tab. Nothing is uploaded anywhere.

No file to hand?

Run a real mix through it and see exactly what comes out. A twelve-track recording running an hour and a quarter.

Or a sample from:

On your phone?

Your project file is probably on another computer. Send yourself the link and pick this up there.

What you get back

A list ready to paste into a YouTube, SoundCloud or Mixcloud description.

0:00 Kestrel Lane - First Light
6:12 Ardent Fields - Paper Harbour
13:15 Nomi Vale - Slow Transit
19:48 The Quiet Wire - Understory

The last chapter is the one you cannot see

Every chapter's length is the distance to the next one, and the last chapter has no next one — its length is whatever remains of the video. The ten-second minimum still applies to it, invisibly, because nothing in the description says where the video ends. An entry dropped near the outro for a final ID can be four seconds long while looking no different from the rest of the list.

It matters because of how the failure behaves. YouTube does not discard the offending entry and keep the others; the whole list stops being chapters, so one afterthought at the end switches off nineteen good ones. This is also the rule that cannot be checked from a project file: the check here compares each entry with the one before it, and a project file says nothing about the length of the finished render. If your last entry sits close to the end, measure that gap yourself.

Lines YouTube reads and discards

Use one timestamp and title per line, in ascending order. Check that 0:00 is present and at least three entries remain. Copy the YouTube preset without bullets or track numbering, then check the saved description.

The shape that reads dependably is the time first, then a space, then the title. Entries get lost when something sits in front of the time — a track number, a bullet, a dash, an opening bracket, an emoji — or when the title has been turned into a link. Those are the decorations a tracklist picks up on its way through a formatted document, a notes app or a forum post.

Two smaller things break lists that are otherwise clean. Times have to climb, so two entries on the same second, or one left out of sequence after a forgotten track went back in, breaks the list from that point down. Past the hour mark the times belong in H:MM:SS rather than a minute count still running past 59:59, which is outside the format YouTube documents.

Formatting chosen for somewhere other than YouTube

Some of those shapes are options here, which makes them worth checking before anything gets rewritten. The numbered tracklist preset puts 1. in front of the time, which is the convention on a forum and the wrong thing in a description box. Title first moves the time into brackets at the end of the line, where YouTube does not look for it.

Precision is the one that catches people out. Set to tenths or milliseconds it writes 1:23.500, which is what a video editor wants and not what a description takes. Choosing the YouTube preset afterwards does not undo it: that preset sets the numbering, the order, the separator, the time style and the opening entry, and leaves precision on whatever was last chosen.

When the description is not the problem

Save your description and reopen the watch page to check it. YouTube does not publish a fixed time by which a changed chapter list must appear; waiting a particular number of minutes does not prove the list is correct.

Manual chapters override automatically generated chapters. If chapters are unavailable, check access to Advanced features and the current YouTube guidance. This tool cannot inspect your channel or enable a YouTube feature.

What can be checked here, and what cannot

The tracklist here is read out of whatever your software already wrote — an Ableton .als, an FL Studio .flp, a rekordbox .cue, a Traktor .nml, or a Serato session or its History CSV export — and then checked against YouTube's rules as you format it. The report names the failing rule and counts: how many entries there are when there are fewer than three, and how many gaps come in under ten seconds. Start at 0:00 adds an opening entry only when the first marker lands after the start, so it can be left switched on without ever displacing a real timestamp.

What it cannot do is see anything on YouTube's side: whether a video is still processing, how long the render is, what the audience setting says. A list that checks clean while the progress bar stays one unbroken line points at the video rather than the text. It cannot identify tracks from audio either — it reads project and session files, and there is no fingerprinting here. Everything runs in your own browser tab, so nothing is uploaded, there is no account, and there is no paid tier.

Questions

Is 00:00 the same as 0:00 for the first chapter?
Yes, the leading zero changes nothing. What does not satisfy the rule is 0:01, or a first entry placed where the first track drops. If the music starts twenty seconds in, add an entry for the intro rather than dragging the first track back to zero — the real transitions should stay where they are.
How long should I wait after editing the description?
Save your description and reopen the watch page to check it. YouTube does not publish a fixed time by which a changed chapter list must appear; waiting a particular number of minutes does not prove the list is correct.
One entry is missing from my chapters. Why that one?
Its line could not be read as a time, and an unreadable line is passed over without a message while the rest carries on. A number or a bullet in front of the time, or a stray character inside it, are the usual causes. If the lost line was the 0:00 entry, or if losing it leaves fewer than three, the whole list stops working.
Could the numbering in front of my times be the problem?
It can be. The numbered tracklist preset here writes 1. before the time, and YouTube reads the time at the start of the line. A title-first layout does the same damage from the other end. The YouTube preset sets numbering to none and the order to time first, but it leaves precision alone, so check that separately.
The list checks clean here and chapters still do not show. What now?
Check the final video duration: the last chapter also needs at least ten seconds. Then check chapter access and the saved description in YouTube. A clean tracklist check here cannot guarantee that YouTube will display chapters.

YouTube’s official chapter requirements

There is also a full tutorial covering all five programs and what to do when the times look wrong.