Search
Clear search
Close search
Google apps
Main menu
true

References

Delete or deactivate references

The YouTube XML format is being replaced by DDEX (music only) and CSV templates (all industries). YouTube strongly discourages any new implementations of the YouTube XML format. This page should be used solely as reference material for existing implementations. Visit Using the YouTube DDEX feed for more information about the new format.
The features described in this article are available only to partners who use YouTube's Content Manager to manage their copyrighted content.

Deleting a reference removes the file from the system; deactivating a reference instructs YouTube to stop trying to match the reference against newly uploaded videos but does not remove it. When you delete or deactivate a reference, you also specify whether to release any existing Content ID match claims made based on that reference.

You can only delete or deactivate a reference if both of the following conditions are true:

 

  • The asset associated with the reference is wholly owned by a single owner.
  • The <file> used to create the reference was not also associated with a <video> to create a YouTube video showing the reference content.

Even though you create a reference indirectly by associating a <file> element with an <asset> element, you delete or deactivate a reference by using the <reference> tag and the reference ID. You set the release_claims attribute to specify whether to release existing claims made based on the reference.

The following samples show how to use the <reference> tag to delete, deactivate, or reactivate a reference.

Deleting a reference

This sample deletes the reference and releases any automatic match claims that YouTube created because an uploaded video matched the reference being deleted.


   <reference action="delete" release_claims="True" id="REFERENCEID" />
Deactivating a reference

This sample instructs YouTube to stop trying to match the reference against newly uploaded videos. As in the previous example, this example releases any automatic match claims that YouTube created because an uploaded video matched the reference being deactivated.


   <reference active="False" release_claims="True" id="REFERENCEID" />
Reactivating a reference

This sample instructs YouTube to start trying to match a previously deactivated reference against newly uploaded videos.


   <reference active="True" id="REFERENCEID" />
Was this article helpful?
How can we improve it?
Resources for Creators

Check out the creator resources available to help you build your channel and connect with the community.