Normally, the Properties page for each asset includes default metadata properties depending upon the MIME type of the asset. Administrators can use the Metadata Schema Editor to modify existing schemas or add custom metadata schemas. AEM Assets Brand Portal provides default forms for assets of various MIME types; however, you can also add custom forms for such assets.
You can edit a newly added or existing metadata schema form. The metadata schema form contains content derived from its parent, including tabs and form items within tabs. You can map or configure these form items to a field within a metadata node.
You can add new tabs or form items to the metadata schema form. The derived tabs and form items (from the parent) are in the locked state. You cannot alter them at the child level.
To edit a metadata schema form, do the following:
The Build Form tab lists items that you can use in your schema form. The Settings tab provides the attributes of each item that you select in the Build Form tab. The following table lists the form items available in the Build Form tab:
Component Name | Description |
Section Header | Add a section heading for a list of common components. |
Single Line Text | Add a single line text property. It is stored as a string. |
Add a multi-value text property. It is stored as a string array. | |
Number | Add a number component. |
Date | Add a date component. |
Dropdown | Add a dropdown list. |
Standard Tags | Add a tag. Note: Administrators might need to change the path value, for example, /etc/tags/mac/<tenant_id>/<custom_tag_namespace>, if they publish the metadata schema form from AEM, where the path does not include tenant information, for example, /etc/tags/<custom_tag_namespace>. |
Smart Tags | Auto-detected tags if you have purchased and configured the AEM smart tags add-on. |
Hidden Field | Add a hidden field. It is sent as a POST parameter when the asset is saved. |
Asset Referenced By | Add this component to view |
Asset Referencing | Add to display a list of assets that reference the asset. |
Asset Rating | Average rating of an asset added from AEM Assets before it is published to Brand Portal. |
Contextual Metadata | Add to control the display of other metadata tabs in the Properties page of assets. |
Not:
Do not use Product References as it is not functional.
To edit the properties of a metadata component on the form, click the component and edit its properties in the Settings tab.
- Field Label: The name of the metadata property that is displayed on the asset's Properties page.
- Map to Property: The value of this property provides the relative path/name to the asset node where it is saved in the CRX repository. It starts with "./" because indicating that the path is under the asset's node.
The following are the valid values for this property:
-- ./jcr:content/metadata/dc:title: Stores the value at the asset's metadata node as the property dc:title.
-- ./jcr:created: Displays the jcr property at the asset's node. If you configure these properties on view properties, we recommend that you mark them as Disable Edit, because they are protected. Otherwise, the error "Asset(s) failed to modify" occurs when you save the asset's properties.
- Placeholder: Use this property to provide the user any relevant information regarding the metadata property.
- Required: Use this property to mark a metadata property as mandatory on the Properties page.
- Disable Edit: Use this property to make a metadata property uneditable on the Properties page.
- Show Empty Field In Read Only: Mark this property to display a metadata property on the Properties page even if it has no value. By default, when a metadata property has no value, it is not be listed on the Properties page.
- Description: Use this property to add a short description for the metadata component.
- Delete icon: Click this icon to delete a component from the schema form.

Not:
All the metadata fields are read-only in the metadata editor form of an asset. Since metadata of the asset must be edited in AEM Assets before an asset is published to Brand Portal.
The default schema form includes the Basic and Advanced tabs. The schema editor lets you add or delete a tab.

Click + to add a new tab on a schema form. By default, the new tab has the name "Unnamed-1." You can modify the name from the Settings tab.

Brand Portal allows you to customize and control the metadata schema so that the Properties page of an asset displays only the specific information you choose to reveal. To control the metadata displayed in the Properties page, remove the required metadata from the metadata schema form and apply it to the specific folder.
To apply a metadata schema form to a folder, do the following:
Not:
If you apply a schema that includes nested schemas to a folder containing video files, metadata properties for the video files may not render properly. To ensure the metadata properties render correctly, remove the nested schemas and apply only the parent schema to the folder.
Brand Portal lets you delete custom schema forms only. It does not let you delete the default schema forms/templates. However, you can delete any custom changes in these forms.
To delete a form, select a form and click the Delete icon.

Not:
After you delete the custom changes made to a default form, the Lock symbol reappears before the form name on the Metadata Schema interface to indicate that the form is reverted to its default state.
In addition to the default forms, you can add custom forms for assets of various MIME types, or create a new form under an appropriate form type. For example, to add a new template for the image/png subtype, create the form under the "image" forms. The title for the schema form is the subtype name. In this case, the title is "png."
You can use an existing template for a different MIME type. For example, use the image/jpeg form for assets of MIME type image/png.
In this case, create a new node at /etc/dam/metadataeditor/mimetypemappings in the CRX repository. Specify a name for the node and define the following properties:
- exposedmimetype: Name of the existing form to be mapped
- mimetypes: List of MIME types that use the form defined in the exposedmimetype attribute
Schema Form | MIME types |
image/jpeg | image/pjpeg |
image/tiff | image/x-tiff |
application/pdf | application/postscript |
application/x-ImageSet | Multipart/Related; type=application/x-ImageSet |
application/x-SpinSet | Multipart/Related; type=application/x-SpinSet |
application/x-MixedMediaSet | Multipart/Related; type=application/x-MixedMediaSet |
video/quicktime | video/x-quicktime |
video/mpeg4 | video/mp4 |
video/avi | video/avi, video/msvideo, video/x-msvideo |
video/wmv | video/x-ms-wmv |
video/flv | video/x-flv |
The following is a list of default metadata properties:
- jcr:content/metadata/cq:tags
- jcr:content/metadata/dc:format
- jcr:content/metadata/dam:status
- jcr:content/metadata/videoCodec
- jcr:content/metadata/audioCodec
- jcr:content/metadata/dc:title
- jcr:content/metadata/dc:description
- jcr:content/metadata/xmpMM:InstanceID
- jcr:content/metadata/xmpMM:DocumentID
- jcr:content/metadata/dam:sha1
- jcr:content/metadata/dam:solutionContext
- jcr:content/metadata/videoBitrate
- jcr:content/metadata/audioBitrate
- jcr:content/usages/usedBy
- jcr:content/jcr:lastModified
- jcr:content/metadata/prism:expirationDate
- jcr:content/onTime
- jcr:content/offTime
- jcr:content/metadata/dam:size
- jcr:content/metadata/tiff:ImageWidth
- jcr:content/metadata/tiff:ImageLength