Skip to content

MetadataTags

James Lockman edited this page Dec 5, 2024 · 2 revisions

Tags

Tags Fields let you constrain the values of a property while allowing entry of multiple values. This is commonly used in keywords-like scenarios, where you want to limit what tags a user can apply. Tags Fields will auto-complete when a user starts typing values.

Similar to a dropdown, you configure the tag values in the Options tab. While this Field type expects pre-defined value from its option list, you can enable users to enter their own values outside of the option list. To enable this feature, enable Allow User Defined Values on the Basic tab.

For example, the following options will constrain the Field to the three possible values dog, cat and bird.

	["dog", "cat", "bird"]

You can also provide a label for each item to make it easier to read or if your users are familiar with another term for the value. Format your array to include label and value pairs for each item. When the user starts typing, the list of options that include the text in either the label or the value will be displayed. When the user selects an item from the list, the labels of the selected items will appear below the text entry, but the value will be recorded on the XMP.

For instance, in the example below, if the user types "do" then the list will display "Doggy". If the user types "at" then the list will display "Kitty". If the user types "y" then the list will display "Doggy", "Kitty" and "Birdy".

	[
		{
			"label":"Doggy",
			"value":"dog"},
		{
			"label":"Kitty",
			"value":"cat"
		}, 
		{
			"label":"Birdy",
			"value":"bird"
		}
	]

Tags do not support parent or group.

Dependencies

You can optionally use Dependencies to set one or more Fields that must have data before a user can enter data in this Field. This Field will be disabled until there is a value present in the Field you specify in Dependencies. Learn more about Dependencies

  • To configure, choose one or more Fields from the Dependencies dropdown in the Advanced tab. The dropdown will display all currently defined Fields, so you will need to define Fields before you can use them as Dependencies for other Fields.You can set one or more Dependencies.
Clone this wiki locally