WAV cue points and markers

Byte layout of the WAV cue chunk and the LIST adtl labels that name each marker, with a worked example from a sample file.

What the cue chunk holds

The cue chunk (with a trailing space) stores marker positions. Its payload starts with a 4-byte count, followed by 24 bytes per cue point. The sample has two points, so its size is 4 + 2 × 24 = 52.

Offset in pointBytesField
04Cue point ID, referenced by labels
44Position
84Chunk ID the point refers to, usually data
124Chunk start, 0 when there is no wave list
164Block start, 0 for PCM
204Sample offset, the frame where the marker sits

Labels live in LIST adtl

Marker names are not in cue . They are in a LIST chunk with form type adtl (associated data list). A labl subchunk holds a cue point ID and a zero-terminated name. A note subchunk has the same layout and holds a comment.

An ltxt subchunk holds a cue point ID, a sample length, a purpose ID such as rgn , country, language, dialect and code page fields, then text. A sample length above zero turns the marker into a region.

The sample has two labl subchunks, "Start" for cue point 1 and "Middle" for cue point 2. Their sizes are 10 and 11: four bytes of ID plus the name and its zero byte.

Reading a marker in the hex view

Select cue . In the hex view, offsets count from the start of the selected chunk, so the first payload byte is at 0x08, after the 4-byte ID and the 4-byte size. The count is at 0x08 and the first cue point starts at 0x0C. The second point starts 24 bytes later at 0x24, so its sample offset is at 0x38: e8 03 00 00, which is 1000. At 8000 samples per second that marker sits at 0.125 seconds.

RIFF Viewer showing metadata.wav with the cue chunk selected and the second marker sample offset, E8 03 00 00, highlighted.
The second marker’s sample offset selected at 0x38. The status line reads it as 1,000.

Compatibility notes

In the sample, Position and Sample offset hold the same value. If they differ in your file, check which one your software reads. Samplers often keep loop points in a separate smpl chunk rather than in cue .

Some editors drop chunks they do not understand when they save. If markers disappear after an edit, put the before and after files into RIFF Compare to see whether cue and LIST adtl survived.

Questions

How do I find the markers in a WAV file?

Load the file and look for a cue chunk and a LIST folder marked adtl. No cue chunk means no standard markers.

What unit are cue positions in?

Sample frames, not bytes or milliseconds. Divide by the sample rate from the fmt chunk to get seconds.

Can a WAV file store regions?

Yes. An ltxt subchunk in LIST adtl with a sample length above zero marks a region starting at its cue point.

Why are my marker names missing?

Names are stored in LIST adtl, separately from positions. If a tool kept cue but dropped adtl, the markers remain without names.

Open the RIFF Viewer with your own file, or download the sample used above.