The grid editor is a spreadsheet-like tool for editing or cloning custom attributes across multiple assets at once.
Accessing the grid editor
To access the grid editor, start with a selection of assets, then choose Edit attributes from the selection bar's action menu.
Individual attributes can be updated independently across the selected assets, either within an attribute's grid block or via the upper input bar above the grid. Any attributes which have been edited during a grid editor session have a yellow cell, and all changes must be saved before they are applied to the assets in the selection.
To edit a single attribute for an asset in the grid, double click the block corresponding to the attribute and the asset you would like to edit. You will be able to edit all attribute types in this way.
Selecting any individual cell enables an input line above the grid where you can edit attribute data for that cell. Once a change has been made, you must use the Apply button before the change will appear in the cell; if you select a new cell without applying the changes, those changes will be lost. After you are finished editing the selected assets, click Save.
One asset's attributes may be applied to any number of other assets in your selection:
- Select the row for the asset with the attribute values you would like to clone.
- Use the Clone button; another grid will replace the original grid and a side pane will appear showing a preview of the asset you chose to clone as well as its attribute values.
- Select any assets from this second grid for which you would like the original asset's attribute values to apply. You can choose multiple rows using shift+click for adjacent rows, or ctrl+click to select multiple rows individually.
- Use the side pane to select or de-select affected attributes. Any attributes which are checked, once cloned, will replace any attribute values for the selected rows with that attribute value. If a value is not checked, no replacement or editing will take place.
- Once your selections have been made, click Apply. Your changes still need to be saved from the main grid editor screen to be fully applied to your assets.
Multiple assets and attributes may be edited at once by highlighting any number of rows and clicking the Edit button. This launches a sidebar attribute editor, much like the quick editor, which allows you to edit any attributes for the chosen assets. These values will replace any existing values, for every chosen asset once the changes have been applied and saved. Any existing values will display, though if you have selected more than one asset with disparate attribute values for an attribute field, the value will appear as < multiple values >. Attributes my be emptied of all values with the icon which accompanies each attribute in the editor.
Text and text area attribute types may be appended rather than replaced. This means that any values inputted, when the appended toggle for that attribute is turned on, will be added to the end of any existing value. You may append values:
- While using the input line method of editing a single cell.
- From the editor sidebar. Note that there will be a single append toggle for the entire action; i.e, if it is toggled on, every text or text area attribute will be appended with any new values inputted during this edit action.
Until you have used the Save button, no values edited during a grid editor session will be added to the selected assets – even if you have applied them with the Apply button in any context. To reset any changes which have occurred during your current session which have not been saved, highlight the cells or assets you would like to reset and use the Reset button that appears at the top of the window. You will be able to see which cells have unsaved changes, as they will appear as yellow blocks rather than white. Note that you may not empty attributes of their values with a reset action if those changes have already been saved.
There are several ways to make a selection of cells in grid editor. Selections can be used along with the Reset, Edit, and Clone buttons. After your selection has been made, all respective cells, rows or columns will be highlighted in dark blue.
- To select an entire column, click the header of a column.
- To select an entire row, click the leftmost number block for an asset.
- To select multiple, non-adjacent cells, hold your keyboard's command button (Mac) or Ctrl button (Windows) while clicking the cells you would like to add to the selection.
- To select adjacent cells, hold your keyboard's shift button while clicking the first cell on the edge of the desired area, then the last cell.
- To select multiple cells in the same area, drag your cursor across the grid along the assets you would like to add to your selection.
To get a closer look at the assets you are editing, you can click on the thumbnail to open a larger preview. Previews are available for image, audio, video, and PDF files.
To see more information about the specific attribute you are editing, right-click on a cell. A window will appear displaying: the attribute's name, value (if any), and the type of attribute. There will also be a thumbnail of the asset in this preview.
Changing this setting to a number higher than 1500 is not recommended in most cases and is an unsupported configuration. This limitation is based on your local computer's ability to process data in the browser.
To limit any performance issues, the grid editor will enforce a maximum of 1500 assets at one time regardless of the number of assets which have been selected. This default, however, may be adjusted using the following property:
Set the value of this property to the maximum number of assets the grid editor will allow users to edit at once.