instantiationLocation may contain information about a specific location for an instantiation, such as an organization’s name, departmental name, shelf ID and contact information. The instantiationLocation for a digital file should include domain, path or URI to the file.

Best practice: For digital files, instantiationLocation should always include a path or URI to the file. There are multiple ways to convey additional information about the location of a carrier or storage medium of the digital file, which are expressed on the PBCore site.

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

Usage: required, not repeatable.


  • 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.
  • ref – optionalThe 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.
  • version – optionalThe version attribute identifies any version information about the authority or convention used to express data of this element.
  • annotation – optionalThe annotation attribute includes narrative information intended to clarify the nature of data used in the element. Can be used as a notes field to include any additional information about the element or associated attributes


instantiationLocation contains no subelements.


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