You're viewing help content for version:

Learn how to define cascading and conditional metadata for assets.

When capturing the metadata information of an asset, users provide information in the various available fields. You can display specific metadata fields or field values that are dependent on the options selected in the other fields. Such conditional display of metadata is called cascading metadata. In other words, you can create a dependency between a particular metadata field/value and one or more fields and/or their values. 

Use metadata schemas to define rules for displaying cascading metadata. For example, if your metadata schema includes an asset type field, you can define a pertinent set of fields to be displayed based on the type of asset a user selects.

Here are some use cases for which you can use and define cascading metadata:

  • Where user location is required, display relevant city names based on the user's choice of country and state.
  • Load pertinent brand names in a list based on the user's choice of product category.
  • Toggle the visibility of a particular field based on the value specified in another field. For example, display separate shipping address fields if the user wants the shipment delivered at a different address.
  • Designate a field as mandatory based on the value specified in another field.
  • Change options displayed for a particular field based on the value specified in another field.
  • Set the default metadata value in a particular field based on the value specified in another field.

Configure cascading metadata in AEM

Consider a scenario where you want to display cascading metadata based on the type of asset that is selected. Some examples

  • For a video, display applicable fields such as format, codec, duration, and so on.
  • For a Word or PDF document, display fields, such as page count, author, and so on.

Irrespective of the asset type chosen, display the copyright information as a required field.    

  1. Tap/click the AEM logo, and go to Tools > Assets > Metadata Schemas.

  2. In the Schema Forms page, select a schema form and then tap/click Edit from the toolbar to edit the schema.

  3. (Optional) In the metadata schema editor, create a new field to conditionalize. Specify a name and property path in the Settings tab.

    To create a new tab, tap/click + to add a tab and then add a metadata field.

  4. Key-values pairs are the options provided to a form-user. You can provide the key-value pairs either manually or from a JSON file.

    • To specify the values manually, select Add Manually, and tap/click Add Choice and specify the option text and value. For example, specify Video, PDF, Word, and Image asset types.
    • To fetch the values from a JSON file dynamically, select Add Through JSON Path and provide the path of the JSON file. AEM fetches the key-value pairs in the real time when the form is presented to the user.
    Both options are mutually exclusive. You cannot import the options from a JSON file and edit manually.


    When you add a JSON file, the key-value pairs are not displayed in the metadata schema editor but are available in the published form.

  5. Add a Dropdown field for asset type. Specify a name and property path in the Settings tab. Add an optional description.

  6. (Optional) Add the other required fields. For example, format, codec, and duration for the asset type video.

    Similarly, add dependent fields for other asset types. For example, add fields page count and author for document assets, such as PDF and Word files.

  7. To create a dependency between the asset type field and other fields, choose the dependent field and open the Rules tab.

  8. Under Requirement, choose the Required, based on new rule option.

    Tap/click Add Rule and choose the Asset Type field to create a dependency. Also, choose the field value upon which to create the dependency. In this case, choose Video. Tap/click Done to save the changes.



    Dropdown with manually predefined values can be used with rules. Dropdown menus with configured JSON path can't be used with rules that use predefined values to apply conditions.

  9. Under Visibility, choose the Visible, based on new rule option.

    Tap/click Add Rule and choose the Asset Type field to create a dependency. Also, choose the field value upon which to create the dependency. In this case, choose Video. Tap/click Done to save the changes.



    Tapping/clicking anywhere on the UI other than values resets the values. In this case, select the values again.


    You can apply Requirement condition and Visibility condition independent of each other.

  10. Similarly, create more dependencies between, say the value Video in the Asset Type field and other fields, such as Codec and Duration.

  11. Repeat the steps to create dependency between document assets (PDF and Word) in the Asset Type field and fields such as Page Count and Author.

  12. Click Save. Apply the Metadata Schema to a folder. 

  13. Navigate to the folder to which you applied the Metadata Schema and open the properties page of an asset. Depending upon your choice in the Asset Type field, pertinent cascading metadata fields are displayed.

    Cascading metadata for Video asset
    Cascading metadata for Video asset
    Cascading metadata for document asset
    Cascading metadata for document asset

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy