Table of Contents
Creating a metadata view
Table of Contents
A metadata view is a collection of metadata fields that is applied to an archive. The metadata view controls the fields across Fotoware user interfaces and plugins, as well as whether they are read-only or editable.
Users can edit metadata in an archive only if they have permission in the archive's access list; at the lowest level, the metadata view controls whether a field is editable at all.
How metadata views affect the uploading of assets to the system
The metadata view assigned to an archive also determines which fields users see and must fill in when uploading assets to it. By setting required fields and, optionally, pairing them with a taxonomy that provides preset values, users will be required to fill in these fields when uploading files to the archive. This applies to all upload methods in Fotoware, including web browsers, FotoWeb Desktop, Adobe Extensions, and the Fotoware mobile app.
Creating a metadata view
- From the Tools menu (cogwheel icon), go to Site Configuration > Metadata > Metadata Views.
- Select Add Metadata View to begin. You can also clone an existing metadata view by selecting the Clone link for the relevant view.
- Enter a name and describe the view using the Name and Description fields in the General tab.
Preserve modification time - turn on this toggle to preserve assets' original date and time stamp on upload.
Adding fields
Below the Name and Description fields, you can add the fields you'd like to expose in an archive using this metadata view (see screenshot above).
Fields that you add here can be assigned to Regions and Zones. These terms describe the areas on the Asset Details page in the web interface where information is displayed.
A Region is a group of fields with a group header and can contain any number of fields. Each region you create can then be assigned to a Zone. Zones relate specifically to the main Fotoware Veloz interface, where the asset details page has two zones: Quick Info, the zone directly below the asset's title to the left of the asset preview, and the Asset Details zone, which contains the asset's preview and additional information tabs. Assigning a region to the Asset Details zone creates a new tab that contains those metadata fields. The tab will be named after the region you chose above.
Note
In the Pro interface, the Region serves as a group header for the fields it contains. Zones are not in use in the Pro interface, but you should still assign a zone to all regions so the metadata view can be used in the main Fotoware interface.
Time and date fields
When you edit a time or date field, you can edit (or remove) the time zone indicator for the field. Metadata fields related to dates and times display a time zone indicator in view mode when a time zone is specified. If a time zone indicator is not specified in the metadata, then metadata fields related to date and time will not display a time zone indicator in view mode.

In view mode, time is calculated based on the local (browser) time, whereas the time zone indicator displays the originally entered time zone.
Creating a region and adding fields to it
To add a region, select Add Region. Name the region and assign it to the zone. Select Add field to choose the fields you want to include.
Field order
Fields will be listed in the order in which the regions and individual fields appear in the metadata view. Both regions and individual fields in a region can be moved up and down using the = icons on each line. You can control the tab order when using keyboard navigation in metadata editors across various user interfaces (such as Fotoware Veloz, Fotoware Pro, and FotoWeb Desktop).
Note
If the metadata configuration is changed so that a metadata view refers to a Field ID that no longer exists in the master metadata configuration, the metadata editor in Fotoware Pro will fail to load. Refer to this troubleshooting article to remedy the situation.
Setting field properties
Each field added to a region has some properties associated with it:
- API: This lets you decide whether to expose this field via the API, allowing other systems to read and modify its contents.
- View: Determines whether users can see the field in the metadata editors in the Fotoware main and Pro interfaces.
-
Edit: Determines whether users can edit the field. If View is enabled but Edit is not, users can see the field's content but cannot modify it.
Note: Even if a field is editable, users can only modify its content if they have Edit text permissions in the archive(s) where the metadata view is assigned. - Required: Determines whether the field must be completed. Users cannot save changes if a required field is empty. When uploading files, all required fields must be completed before the upload can begin.
-
Taxonomy only: Determines whether the field can contain only values from the associated taxonomy. When enabled, users cannot enter free-text values in the field. See the following section for more information.
Note
Enabling some of these properties may also automatically enable others. For example, if you enable Required, Edit will also be enabled.
Taxonomy-related field properties
When a field with a taxonomy associated with it is added to a metadata view, a user who edits that field can choose from the tags added to the taxonomy.
By default, the user can also add a custom tag that is not in the taxonomy. However, if the system administrator has decided that users should only be allowed to choose predefined tags in the taxonomy, they can select the Taxonomy Only option for the field in the metadata view. Then, users will not be able to type custom tags into the metadata field; instead, they will be forced to choose from the tags defined in the taxonomy. Learn more about taxonomies.
Configuring the fields that are used in the Thumbnail view
On the Thumbnail View tab, you can choose which fields to expose in the regular thumbnail grid. Below each thumbnail in the grid, there is a container for metadata split into sections: Label, First line, and Second line. The metadata displayed in these fields can be customized using the radio buttons shown in the screenshot.
Note: You may need to clear your web browser's cache after changing the labels to reflect the update.
![]()
Additional fields
You can also specify additional fields and set the order they appear, as well as in which user interfaces they should appear:
- Desktop App: Shows the field in the FotoWeb Desktop apps and plugins (Uploader, Office plugins, Adobe Extensions)
- Widget: Shows the field in the Selection Widget used in CMS integrations, for example.
- Web: Shows the field in the regular Fotoware user interface in the web browser.
-
Pro: Shows the field in the Fotoware Pro user interface in the web browser.
Built-in fields
.png)
On the Advanced tab, you can see the list of built-in fields. These fields - Title, Description, Tags, Status, Rating, and Notes - are shown in all archives by default.
The first three fields (Title, Description, and Tags) are considered the minimum required metadata for an archive.
If you do not want users to be able to overwrite information already stored in these fields, or you would like to display metadata fields different from the default field numbers 5, 120, and 25 in the built-in Title, Description, and Tags, you can map them to custom fields by using the Browse button next to the field assignment.
Note
The Tags field can only be associated with a bag field to allow multiple entries.
Setting properties for built-in fields
The following properties can be set for built-in fields:
- View - Determines whether users can see the field in the metadata editors in the Fotoware main and Pro interfaces.
-
Edit - Select to make the built-in field editable both during upload, in the General section of the Upload dialog, and after the asset has been uploaded, on the details page in the Quick info panel (see below).

- Required: Determines whether the field must be completed. Users cannot save changes if a required field is empty. When uploading files, all required fields must be completed before the upload can begin.
What's next
After creating a metadata set, you probably want to assign it to an archive.