Metadata allows your managed users to define and store custom data associated with their files in Box. As an admin, you can create templates for your managed users and enable them to keep track of file attributes such as owners, project names or release dates. Metadata makes it much easier to organize, understand and search through all of your Box files. You can reference Box's end-user metadata documentation for more benefits and use cases.
Some features described on this page are only available as part of certain Box packages and add-ons. Please see the Box pricing page or contact User Services for more information. To upgrade your account, please contact your Box account team.
To enable your managed users to start using metadata in Box, create templates that they can choose from and apply to files.
Creating Metadata Templates
- Go to Admin Console > Content.
- Select the Metadata tab.
- Select Create New.
- Select Name Your Template and enter a name.
- Create a name for your first attribute by selecting Name Your Attribute .
- Select the Format down arrow and select the type of data your managed users can enter into the attribute you are creating.
Note
If you select one of the Dropdown options from this menu, you will be given the opportunity to determine options for your managed users to choose from. Simply type an option into the Options field and click Add Option to add additional fields.
- Use the Description field to incorporate additional information about the attribute.
- Select New Attribute to add additional attributes.
- Use the Status drop down to indicate whether this template is Visible to your managed users or Hidden for the time being.
- Select Save.
You must have at least one attribute in the template in order to save your template.
There are some limits to the number of templates, attributes, and items you can create when working with metadata templates. Review this article for more information on the limits as well as how to structure metadata for your enterprise.
Editing Metadata Templates
- Go to Admin Console > Content.
- Select the Metadata tab. A list of metadata templates displays.
- Select the template you wish to edit.
- Make any desired changes.
- Select Save.
While editing a saved template, you can still add attributes by clicking Add Attribute. You can also hide existing attributes by clicking Hide, or delete existing attributes by clicking Delete. Within an attribute you cannot make changes to the Format field unless the format is a dropdown list. If you selected Dropdown for your format, you can add or delete options.
Note: if you delete an existing attribute, any files or folders with this attribute will no longer have this attribute. The associated attribute values will be deleted and cannot be undone.
If a metadata template or attribute is associated to an active retention policy, you cannot delete the template, attribute, or dropdown option until you have retired the retention policy.
Deleting Metadata Templates
You can delete metadata templates using the Metadata Template Deletion API. This is not yet available in the Admin Console.
Once you have deleted a given metadata template, the metadata template instances that are associated with your files will also be deleted. This action cannot be undone.
If a metadata template or attribute is associated to an active retention policy, you cannot delete the template, attribute, or dropdown option until you have retired the retention policy.
Hiding Metadata Templates
If you have any templates that you want to hide from users, whether this is a template you are still developing or if this is a template you want available only via API, you can hide these from managed users today.
- Go to Admin Console > Content.
- Select the Metadata tab. A list of metadata templates displays.
- Select on the template you wish to hide.
- From the Status dropdown menu, select Hidden.
To revive a template, simply follow the steps above and select Visible from the Status dropdown menu.
Admin Report Logging
The creation, update, and deletion of metadata templates and metadata values are available in the Box User Activity Report. If the metadata template is changed or deleted, only one event is logged noting the template change/deletion. There is no separate event logged for all template values associated with files or folders that are impacted.