<!--
{
  "availability" : [
    "tvOS: 9.0.0 - 13.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "TVServices",
  "identifier" : "/documentation/TVServices/TVContentIdentifier",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "TV Services"
    ],
    "preciseIdentifier" : "c:objc(cs)TVContentIdentifier"
  },
  "title" : "TVContentIdentifier"
}
-->

# TVContentIdentifier

An object that uniquely identifies media content in either a single piece or a collection.

```
class TVContentIdentifier
```

## Overview

Every content identifier is represented by two parts: a string identifier ([`identifier`](/documentation/TVServices/TVContentIdentifier/identifier)) and a container identifier ([`container`](/documentation/TVServices/TVContentIdentifier/container)). The container identifier may be `nil`, which indicates that the content lives at the top level of the container hierarchy. You are responsible for organizing your content into a hierarchy and creating identifiers that uniquely identify each piece of content.

When designing your content identifiers, follow this guidance:

- A given content identifier must be unique for a particular content item, across *all* past, current, and future content items, even if the user no longer has access to that item.
- The uniqueness of a content identifier comes from the uniqueness of its two parts. The [`identifier`](/documentation/TVServices/TVContentIdentifier/identifier) property of a content identifier need not be universally unique across all of the app’s content identifiers, as long as items that share the same identifier string are contained in different containers.

## Topics

### Initializing a Content Identifier

[`init(identifier:container:)`](/documentation/TVServices/TVContentIdentifier/init(identifier:container:))

Creates a new content identifier.

[`init(coder:)`](/documentation/TVServices/TVContentIdentifier/init(coder:))

Returns an object initialized from data in a given unarchiver.

### Inspecting an Identifier’s Contents

[`identifier`](/documentation/TVServices/TVContentIdentifier/identifier)

The string that identifies this content item.

[`container`](/documentation/TVServices/TVContentIdentifier/container)

The container that this content item is contained in.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)