Editing QC Items (data model 2026-04)

QC Items are being republished so that they follow the EBU QC data model 2026-04. This page explains what that changes in the Item editor.

Two data models, two API generations

Every version of an Item records the data model it was made under. The Item page shows it as a label next to the version number:

Legacy (pre-2026-04): all versions that existed before the switch. API v1 and v2 serve these versions only.
EBU QC data model 2026-04: every version created since. API v3 serves these versions only.

A new version of an older Item is always a 2026-04 version. The label is set once and never changes.

Republishing an Item for the 2026-04 data model counts as a substantial change, so it gets a new MAJOR version number (see Versioning).

Colour key

Some fields exist in only one of the two API generations. The edit and show pages tint them, with a small text label, and show a colour key above the Inputs and Outputs:

Light blue, label "v3": only in API v3 (data model 2026-04). These are the Check result definition and the four positioning flags (Has locator (temporal), Has locator (spatial), Has track, Has wrapper location).
Grey, label "v1/v2 only": only for API v1/v2. This is the old Locator. It is derived from the flags and cannot be edited.
No tint: used by both.

On a legacy version, the v3-only fields read "not in this version".

Check result definition

The Check result definition describes what a check reports when it finds a problem. It is needed for every Item that is usable as a check.

When such an Item has no Check result definition yet, the edit form pre-fills a suggestion that starts with [TO BE VERIFIED]. The suggestion is the Description of the Item's old "CheckResult" Output when there is one, otherwise a generic sentence. Only the form is pre-filled; published versions are not changed.

Read the suggestion, correct it where needed, and remove "[TO BE VERIFIED]". As long as the text still starts with that marker, the version cannot move to Publication ready or Published.

Positioning flags (replacing Locator)

API v1/v2 had one Locator flag per Input or Output. The 2026-04 data model replaces it with four independent flags:

Has locator (temporal): the value refers to a time position or segment in the content.
Has locator (spatial): the value refers to a position in the picture.
Has track: the value refers to a specific track.
Has wrapper location: the value refers to a location in the file wrapper.

The old Locator is now derived: it is on when Has locator (temporal) or Has locator (spatial) is ticked. A child no longer inherits it from its parent; each row has its own flags.

For a row that had Locator on but none of the new flags, the edit form pre-ticks Has locator (temporal), because most old Locators are time segments, and shows the hint "Pre-ticked from the old Locator: verify." Check it, and tick Has locator (spatial) instead (or as well) for a position in the picture. If you untick both locator flags, the old Locator is cleared when you save.

Item checks

The edit page has an Item checks button with two counters: red for blocking findings, orange for findings to review. Open it to see what still needs attention under the 2026-04 data model. It updates as you type, before you save.

The panel has three tabs:

Blocking: must be fixed before the Item can move to Publication ready or Published. Drafting and review are not blocked.
To review: worth a look. Fix the finding, or click Confirm if it is intended. Confirmations are saved with the version and carried to later versions; Undo takes one back.
OK: the checks that pass, and the findings you confirmed.

Blocking checks:

The fields required for publication are filled (Name, Definition, card title and lines, card image).
The Check result definition is filled for an Item usable as a check, and no longer starts with "[TO BE VERIFIED]".
Every Input and Output has a data model name, unique at its level.
Every Input and Output that needs a value has a Type.

Checks to review:

The Item and its Inputs and Outputs have a Description.
The card lines are all different.
The text follows the catalogue style: Definition and Descriptions start with a capital letter, the Definition ends with a full stop, no double spaces, data model names in PascalCase (for example ProgrammeCount).
Ranges spell "infinity" in lower case.
No placeholder Unit such as "-": leave the Unit empty instead.
Type, Unit and Range are official parameters.
At least one Input or Output sets a positioning flag, or you confirmed that none applies.
The Item has References and Examples.

Rules for Inputs and Outputs

From Tech review onward, saving checks the Inputs and Outputs against Annex C.4 of the 2026-04 data model. An error is shown on the row concerned:

The data model name is unique (ignoring upper and lower case) among all Inputs, children included, and separately among all Outputs.
The data model name contains only letters, digits and "-", and does not start with "-" or "PRIVATE".
In checks and In measurements are not both "not applicable". A child is "not applicable" wherever its parent is.
A top-level Input or Output without a Type sets at least one positioning flag. A top-level Input without a Type also has one or more children.
A child Input has a Type. A child Output has a Type or sets a positioning flag.
An Item usable in reports has at least one top-level Output with In measurements set to required or optional. If it has only one, that one is required.

These apply on every save, whatever the status:

A row with children has no value of its own, and there is only one level of nesting.
When Needs a value is unticked, the row's value fields are hidden, and its Default value and Alias are cleared on saving.

Unit, Representation and Range are optional

In the 2026-04 data model, Unit, Representation and Range are optional. The editor accepts them empty, also for publication; each picker has a clear button (for the Unit, "No unit"). A value you do enter must still be allowed by the Type, and a Range must be official from review onward.

A count has no unit: leave the Unit empty rather than choosing "-".