instantiationDimensions is an element that specifies either the dimensions of a physical instantiation, or the high-level visual dimensions of a digital instantiation

Best practice: For physical dimensions, usage examples might be 7″ for an audio reel. When describing visual dimensions, use this for high-level descriptors such as 1080p. Use the element frameSize to describe the pixel dimensions of a visual resource.

instantiationDimensions can be contained by the elements pbcoreInstantiation, pbcoreInstantiationDocument, and instantiationPart.

Usage: optional, repeatable.


  • unitsOfMeasureoptional. The unitsOfMeasure attribute defines the unit used in the containing element, e.g. pixels, GB, Mb/s, ips, fps, kHz, inches, lines, dpi. We recommend standardizing the notation that is most widely recognized in your institution and using with consistency
  • source – optional. The source attribute provides the name of the authority used to declare the value of the element. Different elements will use the source attribute slightly differently. For example, identifier source (required) should be the name of the organization, institution, system or namespace that the identifier came from, such as “PBS NOLA Code” or an institutional database identifier. For other elements, this might be the name of a controlled vocabulary, namespace or authority list, such as Library of Congress Subject Headings. We recommend a consistent and human readable use.
  • refoptional. The ref attribute is used to supply a source’s URI for the value of the element. Attribute ref can be used to point to a term in a controlled vocabulary, or a URI associated with a source.
  • versionoptionalAttribute version identifies any version information about the authority or convention used to express data of this element.
  • annotationoptional. The annotation attribute includes narrative information intended to clarify the nature of data used in the element. This attribute can be used as a notes field to include any additional information about the element or associated attributes


instantiationDimensions contains no subelements.


Submit any issues or suggested changes for future schema iterations by creating a ticket in our Github repository.