Setting up custom columns
Folders in Docly list a fixed set of columns: name, modified date, size and type. Custom columns let you show extra fields from the documents in the folder — schema properties, computed values or a sort key — and decide how the folder is sorted, including drag-and-drop ordering. This guide walks through how to set them up in the folder properties dialog.
Open folder properties
Place the cursor over the folder you want to modify, press the right button on your mouse or trackpad. This will open a context menu with various options related to the folder. From the context menu, locate and click on the "Properties" option. This will open a new window containing details about the selected folder and its configuration.
Check the folder type
Custom columns are available on the built-in folder types "Folder" and "Published folder". The folder type is shown on the "General" tab. If your folder has another type, click "Change ..." next to "Folder type" and choose one of them.
Open properties tab
Click the "Properties" tab to see and change the folder settings.
Check the box that says "Specify custom columns"
Specify desired columns in the list that shows up below the checkbox.
Enter columns
Each column has a title, a column / formula and a "Sort list by" choice. The formula is a JavaScript expression evaluated for each document in the folder; a bare field name such as Order reads that field from the document, and parseInt(Order) reads it as a number.
Sort list by | What it does |
|---|---|
No | Shows the value as a plain column. The folder is not sorted by it. |
Ascending | Lists the folder by this column, lowest value first. |
Descending | Lists the folder by this column, highest value first. |
Sortable | Lists the folder by this column and adds drag-and-drop ordering. Drag a row by its icon; Docly then renumbers the field 1, 2, 3 ... on every document in the folder and saves them. |
To preview images in the folder, use a formula such as Image(propertyName), where propertyName is the image field on the documents.
Sorting a folder only changes the order in the Docly folder view. To show the same order on a published page, sort by the same field in your template. Full walkthrough: https://developers.docly.net/Guidelines/KB/Sort-folder-contents-by-a-custom-field