TOPICS×
Use the metadata schema form
A metadata schema describes the layout of the Properties page and the metadata properties displayed for assets that use the particular schema. The schema that you apply to an asset determines the metadata fields that appear on its Properties page.
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.
Add a metadata schema form
To create a new metadata schema form, do the following:
- From the AEM toolbar at the top, click the Adobe logo to access administrative tools.
- From the administrative tools panel, clickMetadata Schemas.
- On theMetadata Schema Formspage, clickCreate.
- In theCreate Schema Formdialog box, specify the title of the Schema form, and then clickCreateto complete the form creation process.
Edit a metadata schema form
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:
- From the AEM toolbar at the top, click the Adobe logo to access administrative tools.
- From the administrative tools panel, clickMetadata Schemas.
- From theMetadata Schema Formspage, select a schema form to edit its properties, for example,collection.Unedited templates display a lock symbol before them. If you customize any of the templates, the Lock symbol before the template disappears.
- From the toolbar at the top, clickEdit.TheMetadata Schema Editorpage opens with theBasictab open on the left and theBuild Formtab open on the right.
- In theMetadata Schema Editorpage, customize thePropertiespage of the asset by dragging one or more components from a list of component types in theBuild Formtab to theBasictab.
- To configure a component, select it and modify its properties in theSettingstab.
Components in the Build Form tab
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.
|
Multi ValueText
| 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 list of assets referenced by the asset.
|
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.
|
Do not use
Product References
, as it is not functional.
Edit the metadata component
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.

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.
Add or delete a tab in the schema form
The default schema form includes the
Basic
and
Advanced
tabs. The schema editor lets you add or delete a tab.

- To add a new tab on a schema form, click+. By default, the new tab has the name "Unnamed-1". You can modify the name from theSettingstab.

- To delete a tab, clickx. ClickSaveto save the changes.
Apply a metadata schema to a folder
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:
- From the AEM toolbar at the top, click the Adobe logo to access administrative tools.
- From the administrative tools panel, clickMetadata Schemas.
- From theMetadata Schema Formspage, select the schema form that you want to apply to an asset, for example, clothing.
- From the toolbar at the top, clickApply to Folder(s).
- From theSelect Folder(s)page, navigate to the folder to which you want to apply theclothingmetadata schema, for example,Gloves.
- ClickApplyto apply the metadata schema form to the folder.The metadata available in theclothingmetadata schema form is applied to theGlovesfolder and visible in thePropertiespage of the folder.
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.
Delete a metadata schema form
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.

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.
Schema forms for MIME TYPES
Adding new forms for MIME types
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".
Using an existing schema template for various MIME types
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:
Name
| Type
| Value
|
---|---|---|
exposedmimetype
| String
| image/jpeg
|
- exposedmimetype: Name of the existing form to be mapped
- mimetypes: List of MIME types that use the form defined in theexposedmimetypeattribute
Brand Portal maps the following MIME types and schema forms:
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