Titles, names and notices

DDEX delivers titles and names many times over — once per language and script, and sometimes once per territory — and //SCHEMA keeps every variant exactly as delivered. The convenience fields (Release.title, Party.name) pick one; these types are the full set, filterable by language, script, territory and type.

Copyright notices come in two kinds that must not be confused: ℗ (P-line) covers the sound recording; © (C-line) covers the composition or artwork. They are separate types for that reason.

See Work with localized metadata.

The LocalizedText object#

One title or name, with its language, script and territory qualification.

Attributes

valueString!
The text itself, exactly as delivered.
typeStringnullable
The DDEX text type — DisplayTitle, FormalTitle, FullName, …
languageStringnullable
The full language-and-script tag exactly as delivered — en, ja-Jpan, zh-Hans-CN. null when the sender gave none.
scriptStringnullable
The ISO 15924 script subtag taken from language, for convenience: ja-Jpan yields Jpan. null when the tag carries no script.
territoryStringnullable
The territory this variant applies to. null means the sender did not qualify it, which is not the same as Worldwide.
isDefaultBoolean!
Whether the sender marked this as the default variant. Often false on every variant.

The LocalizedText object

{
  "value": "夢のララバイ",
  "type": "DisplayTitle",
  "language": "ja-Jpan",
  "script": "Jpan",
  "territory": null,
  "isDefault": false
}

The Pline object#

A ℗ (phonogram) copyright notice — the right in the sound recording.

Attributes

valueString!
The full notice text, e.g. (P) 2025 Lanternfish Records.
yearStringnullable
The year exactly as delivered. A string, because senders do not always send a bare year.
companyStringnullable
The rights holder, when given separately from value. Usually null.
languageStringnullable
The full language-and-script tag exactly as delivered — en, ja-Jpan, zh-Hans-CN. null when the sender gave none.
scriptStringnullable
The ISO 15924 script subtag taken from language, for convenience: ja-Jpan yields Jpan. null when the tag carries no script.
territoryStringnullable
The territory this variant applies to. null means the sender did not qualify it, which is not the same as Worldwide.
isDefaultBoolean!
Whether the sender marked this as the default variant. Often false on every variant.

The Pline object

{
  "value": "(P) 2025 Lanternfish Records",
  "year": "2025",
  "company": null,
  "language": "en",
  "script": null,
  "territory": null,
  "isDefault": true
}

The Cline object#

Attributes

valueString!
The full notice text, e.g. (C) 2025 Lanternfish Publishing.
yearStringnullable
The year exactly as delivered, as a string.
companyStringnullable
The rights holder, when given separately. Usually null.
languageStringnullable
The full language-and-script tag exactly as delivered — en, ja-Jpan, zh-Hans-CN. null when the sender gave none.
scriptStringnullable
The ISO 15924 script subtag taken from language, for convenience: ja-Jpan yields Jpan. null when the tag carries no script.
territoryStringnullable
The territory this variant applies to. null means the sender did not qualify it, which is not the same as Worldwide.
isDefaultBoolean!
Whether the sender marked this as the default variant. Often false on every variant.

The CopyrightLineInput input object#

One ℗ or © notice to set, in plines or clines. The same shape serves both; which right it states is decided by the list it is in.

Fields

textString!required
The notice as displayed, e.g. (P) 2026 Lanternfish Records. Stored exactly as given.
yearString
The year, as a string.
companyString
The rights holder, when not only inside text.
languageAndScriptCodeString
A BCP-47 tag such as en or ja-Jpan, when the notice is in one language. The script is extracted as it is from a delivery.
territoryString
Leave unset unless the notice applies to one territory only. Unset is not the same as Worldwide.
isDefaultBoolean!Default: false
The default among several. At most one per list; when none is marked, the first is.