MaxCLL

Also known as: Maximum Content Light Level

On this page 7

MaxCLL, or Maximum Content Light Level, is a static metadata value in HDR video that states the luminance of the brightest single pixel anywhere in a program, expressed in candelas per square meter (nits). It is defined in the CTA-861.3 specification and carried in HDR10 streams together with MaxFALL and the mastering display information from SMPTE ST 2086.

A display reads MaxCLL to learn how bright the content actually gets, as opposed to how bright the mastering monitor could get. With that knowledge, a television whose peak luminance is lower than the content can choose a more appropriate tone mapping curve and preserve highlight detail instead of clipping it.

How MaxCLL is calculated

MaxCLL is measured across every frame of the finished program. For each pixel, the encoded PQ values of the red, green and blue components are converted to linear light, and the maximum of the three components is taken as that pixel’s light level. The highest such value found in the entire program becomes MaxCLL.

Because it uses the maximum RGB component rather than true luminance, a saturated red or blue highlight can produce a higher MaxCLL than its visual brightness suggests. The value is rounded to an integer in nits, and a value of 0 means unknown, which tells the display to fall back on other metadata.

FieldWhat it describesTypical range
MaxCLLBrightest pixel in the whole programAbout 500 to 4,000 nits; 10,000 nits is the format ceiling
MaxFALLHighest frame-average light levelAbout 100 to 400 nits
Mastering display max luminancePeak of the grading monitorCommonly 1,000 or 4,000 nits
Mastering display min luminanceBlack level of the grading monitorAbout 0.0001 to 0.05 nits
Mastering primaries and white pointColor volume of the grading monitorUsually P3 primaries with D65 white
MaxCLL and related static HDR metadata

Why displays need MaxCLL

HDR content encoded with the PQ transfer function can describe up to 10,000 nits, yet consumer displays typically reach only a few hundred to around 2,000 nits. The display must therefore compress highlights through tone mapping, and the shape of that compression depends on how much headroom the content really needs.

Without MaxCLL, a television often assumes the content reaches the mastering display peak, for example 4,000 nits. If the actual brightest pixel is only 1,000 nits, the display compresses highlights unnecessarily and the image looks dimmer and flatter than intended. With an accurate MaxCLL, a 1,000-nit television can display that content almost without tone mapping.

Content MaxCLLDisplay peakLikely behavior
600 nits800 nitsLittle or no tone mapping needed
1,000 nits600 nitsModerate highlight roll-off
4,000 nits600 nitsStrong compression of highlights
0 (unknown)600 nitsUses mastering peak or a default curve
How a display may react to different MaxCLL values

Actual behavior varies widely between manufacturers. Some televisions ignore static metadata entirely and apply their own analysis, while others follow MaxCLL closely, which is one reason why the same HDR10 file can look different on different screens.

MaxCLL compared with dynamic metadata

MaxCLL is static metadata: one number for the whole program. A film with a single bright explosion receives a high MaxCLL even if almost every scene is dim, so the display applies the same conservative curve to the quiet scenes as well. This is the main limitation of HDR10’s static approach.

FormatMetadata typeGranularityEffect on tone mapping
HDR10Static, including MaxCLLWhole programOne curve for all scenes
HDR10+DynamicScene or frameCurve adapts to each scene
Dolby VisionDynamicShot or frameDetailed trims for target displays
HLGUsually noneNot applicableDisplay-relative, scene-based signal
Static and dynamic approaches to HDR metadata

Even with dynamic formats, MaxCLL is still written as a fallback for devices that only understand HDR10. Dynamic metadata effectively provides a per-scene equivalent, allowing dark scenes to keep their shadow detail without being dimmed by one bright moment elsewhere.

Measuring and setting MaxCLL in practice

In HDR mastering, MaxCLL is normally analyzed from the final graded master rather than typed in by hand. Grading and encoding tools scan every frame and report MaxCLL and MaxFALL, which are then inserted into the HEVC SEI messages or container metadata of the delivery file.

  • Measure after the final grade, because any later change in highlights invalidates the value.
  • Remove stray hot pixels or graphics overshoots that would otherwise set an unrealistically high MaxCLL.
  • Keep metadata consistent across versions of the same program, such as trailers and full features.
  • Check delivery specifications, since some streaming platforms require MaxCLL and MaxFALL to be present and plausible.

A frequent practice is to limit highlights during grading to the agreed target, often 1,000 nits, so that MaxCLL matches the mastering display. This makes playback more predictable across consumer devices.

Common errors and misconceptions

  • MaxCLL is not the display peak. It describes the content, while peak luminance describes the screen.
  • MaxCLL is not the mastering monitor peak. A 4,000-nit monitor can produce content whose MaxCLL is far lower.
  • Default or copied values cause problems. Reusing metadata from another title can mislead tone mapping.
  • A single bright pixel can dominate. One specular glint or a graphics error can raise MaxCLL for the whole program.
  • MaxCLL does not exist in SDR. It applies only to HDR signals, most often PQ-based HDR10.

A non-technical view

MaxCLL is a small label attached to an HDR film or show. It tells the television how bright the brightest spot in the whole program is. The number is given in nits, the unit used for screen brightness.

The television uses this label to plan ahead. If the brightest spot is within what the screen can show, it plays the picture almost as made. If the content is brighter than the screen, the television gently squeezes the brightest parts. The goal is to keep detail in bright areas instead of turning them into flat white.

A concrete example

A post-production house finishes a nature documentary in HDR10 on a 1,000-nit mastering monitor. Most scenes are forest interiors with highlights around 300 to 500 nits, but sunlight on water in one sequence reaches about 950 nits. After the final grade, the analysis tool reports a MaxCLL of 950 nits and a MaxFALL of 180 nits.

During quality control, an engineer notices that an earlier draft reported 4,000 nits. The cause was a single white title frame rendered at the maximum PQ value. After the title is corrected and the program is analyzed again, the metadata is set to 950 nits.

On a typical 700-nit television, the corrected file now needs only gentle highlight roll-off. The forest scenes keep their intended brightness, and the reflections on the water retain visible texture instead of being needlessly compressed.