Lists allow you to group folders, tasks, or versions from anywhere in your project into one view. Use them to track tricky shots, review versions, or keep things organized your way.

Lists are a flexible way to organize work in AYON, going beyond the standard folder and task hierarchy. They let you create custom collections of folders, tasks, and versions from across the project, all in one place.

You can create a list for anything: shots to review, tasks to track, versions to compare, or even a personal to-do list. There are no limits on what you can add or how much of it.

Whether you’re a lead prepping dailies, a supervisor tracking notes, or an artist gathering references, Lists help you focus on what matters most.

Working with lists

Create New Lists

You can create a new list by clicking the Add (+) button or using the shortcut N on your keyboard. A window will pop up, allowing you to specify the list name and the entity type, which determines what kind of items you can add to the list.

Alternatively, in the Project Overview Page, you can right-click any item and select + New list from the Add to list submenu. This creates a new list and adds the selected items to it.

Currently, you can choose between three entity types:

• Folder

• Version

• Task

Manage Lists

Right-clicking on any list provides the following options:

• Rename: Change the list name or by double clicking the list name.

• Info: View details like ID, label, entity type, item count, owner, etc.

• Clear list: Remove all items from the list (only in developer mode).

• Delete: Permanently delete the list (hold ctrl/cmd to delete without confirmation).

Filtering Lists

In the lists view on the left, you can filter the displayed lists by clicking the filter icon. A pop-up window will appear, letting you choose a filter. At the moment, the only available filter is by list entity type.

The search icon 🔍 on the lists page lets you quickly filter lists by matching their names with your entered text.

Add/Remove Items

You can add items to a list by selecting them and using the Add to List option from the right-click menu on the Project Overview Page.

You can remove items from a list by selecting them in the list view, right-clicking, and choosing Remove from List. Alternatively, use the shortcut Ctrl/Cmd + Backspace. (This action can be undone.)

The Lists Page also supports additional editing actions like Undo, Redo, and Remove from list.

Adjust View

The Lists Page shares many features with the Project Overview Page, such as filtering, customizable panels, and spreadsheet-style editing. It also includes unique features like ordering list items. Some columns, particularly in version lists, are read-only and marked with a lock icon.

List Attributes (⚡ Power Feature)

What Are List Attributes?

List attributes are custom fields you can add to each list. They appear as extra columns in your table, allowing you to modify them for each list item. Each list is independent, meaning attributes are not shared between lists.

Why Are They Useful?

List attributes let you customize your workflow to fit your needs. Here are some examples:

• Approval Tracking: If multiple directors need to approve a task before delivery, you can add a checkbox attribute for each director (e.g., Director_1, Director_2) and have them tick their respective boxes.

• Additional Information: Use attributes to add details like delivery dates or editorial notes specific to a list. For example, if a list represents a different commercial cut, you can include relevant info for that cut.

• Vendor Management: When sending work to different vendors, create attributes for the assigned vendor, the deadline, and the current status of the vendor's work.

• Shot Tracking in Commercial Cuts: For a list of shots used in multiple cuts, add attributes to track whether a shot is included in the edit, the required format (e.g., square, horizontal, vertical), or notes specific to that cut.

How to Manage List Attributes

• Create New Attributes: Click the ⚙️Customize button in the top right, go to List Attributes, and select + Add Attribute. Alternatively, click the + button at the end of the table to add a new attribute directly.

• Rename Attributes: In the List Attributes view under ⚙️Customize, click the ✏️ pencil icon next to an attribute to rename it.

• Remove Attributes: In the List Attributes view under ⚙️Customize, click the 🗑️ trash icon next to an attribute to delete it.

List Actions

Each list can have its own actions that can run on the entire list. While no actions are currently implemented, this feature will evolve in future updates.

List actions can be added through a custom addon, such as a studio addon, allowing studios to integrate their own workflows into AYON.

List Access Permissions

In the community version, all users can see all lists. However, if an entity in a list is private, users without access will not see it.

Future Iterations

This is the first iteration of the Lists feature. Planned improvements include:

• List categories and tags for better organization.

• Set attribute values to only the list item without committing them to the original entity. (⚡ power feature).

• Filter by list on Overview, Task Progress, and Browser pages.

• Create new review sessions from a list (requires Review Addon).

• Ability to set permissions on lists e.g., access for specific users or teams. (⚡ power feature).