|Video Cloud||New Studio||Professional, Enterprise|
In this topic you will learn how to add custom metadata fields to your videos.
Custom metadata can be used to add additional metadata fields to your videos. Custom fields are added as part of your account settings. After the custom fields have been added, the fields can be assigned values using the Media module.
This topic contains the following sections:
To create custom metadata fields, follow these steps.
Note: There are some reserved words that must not be used as custom field internal names (the display name does not matter). One common name is category. If you use category as the internal name for a custom field, searches on that field will return no results. If you already have a custom field named category, replace it and use a field with a different name. To delete the field, see the Deleting custom metadata fields section of this topic.
Note: if custom field values have less than three characters, you will not be able to search for videos based on that value either in Studio or using the CMS API. So for example, if you want to create a boolean-like custom field,
isfeatureitem, make the value list
no; if you use the latter values, you will not be able to find videos using the search
When you have finished adding all the values, click Save Changes.
Custom metadata fields you create are available immediately and will be visible in the Media module.
Up to 10 custom metadata fields can be created. If you need more than 10 fields, click the Need more fields? link in the Video Fields page to contact Brightcove Customer Support with a request for more. Publishers are limited to 50 custom metadata fields.
You can edit the possible values for a list type custom metadata field. Click the list of values link and either add new values or delete existing ones.
In order to delete a custom metadata field, you must contact Brightcove Support. Note that if you have Brightcove Support delete custom metadata fields, the modified date will change for any videos where a value was present.
Custom metadata fields can be exported so that you can keep a record of them outside of Video Cloud. Click the Copy link to copy to your clipboard a tab-delimited list of the custom metadata fields, including the display name, internal name, type, and (for list type fields) values. You can then paste this information into a spreadsheet or text file.
Custom metadata fields can be accessed programmatically using one of the Video Cloud APIs. The following developer documents provide more information.