Reviewables

Last updated 28 days ago

Reviewables were introduced in 1.3.0.

AYON Web Viewer interface displaying a 3D robot character for review. Top navigation shows project path "demo_Commercial / shots / sh100 / renderCompositingMain / v004". Right sidebar includes the Activity Feed with a comment from Louis Idris approving version v004 over v003. Player controls at the bottom include timeline, frame counter at 36, and playback buttons. Technical overlays include color chips and a chrome ball on the frame.
Robot character review in the AYON Web Viewer with version approval comments.

Overview

The reviewables feature streamlines the version review process, making it both simple and powerful. Traditionally, each version could only have a single "representation" for reviewing. Reviewables revolutionize this by allowing you to create and manage as many focused review elements as needed for a single version. These reviewables can be conveniently uploaded and managed directly within the web interface.

Here are some examples of how reviewables could be utilized:

  • A model needs to be reviewed with multiple different lighting setups.

  • A complex model needs to have be viewed close up.

  • An animation needs to be viewed from multiple angles.

  • An environment needs to show different areas in more detail.

Reviewables Tab

Every version has a "Files" tab that can be used to view, manage and upload new reviewables. To upload a reviewable drag and drop a media file over the reviewables area or click the dropzone to pick a file.

AYON Reviewables management panel for "renderCompositingMain v004" by Lias Wallin. Under the "Reviewables" header, two video files are listed with thumbnails: "turntable.mp4" and "turntable_zoomed.mp4". A dotted "Drop or click to upload" area is at the bottom. A blue box highlights the "Reviewables" list icon in the sidebar header.
Managing multiple reviewable media files for a single product version.

Download the original video by right-clicking the file and selecting "Download Original."

Default File Support

For the best playback performance and experience use the recommended codec.

  • Recommended: mp4: yuv420p, h.264, qtfaststart flag enabled, iframe only

  • Supported Containers: .mp4 .mov (commonly supported, but not guaranteed for all variations)

  • Video Codecs: H.264, AV1, VP8, VP9 (Preferably encoded with I-frames only for optimal compatibility)

  • Image Formats: PNG, JPEG, WebP

Uploaded files are not transcoded or converted. You will see a message to let you know if a reviewable file is not viewable.

List of product version reviewables in AYON showing varied status. Top item "cg_robot_renderRenderMain_beauty_v003_h264.mp4" is ready for review. The next two items, "pin_projects.mov" and "media_banner.psd", display an eye icon with a diagonal slash and text "Unsupported - conversion required", indicating they need transcoding for web viewing.
Reviewables list showing files requiring server-side conversion.

Web Viewer

You can quickly view a Reviewable by using the Web Viewer. To open the viewer:

  1. Click on a reviewable

  2. Click on any entity thumbnail

  3. Press spacebar on any selection for folders, tasks and versions.

AYON Products page UI with numbered annotations indicating three methods to launch the Web Viewer. 1: "Reviewable" points to a specific media file (main.mp4) in the side panel. 2: "Thumbnail" points to the large preview image of the product version. 3: "Card" points to the active version card (v003) in the product grid, representing the spacebar shortcut target. Background shows asset hierarchy and version history within the AYON project browser.
Three ways to launch the Web Viewer: clicking a specific reviewable file (1), clicking the version thumbnail (2), or using the spacebar on a selected version card (3)

Player Controls

The viewer comes with all the player controls you would expect and we plan to add more advanced controls in the future.

  • Play/Pause Spacebar

  • Next/Previous frame Left and Right arrows

  • Next/Previous 5 frames Shift Left and Right arrows

  • First frame Shift A

  • Last frame Shift D

  • Full screen F

  • Mute M

  • Looping

  • Grid overlay

  • Scrubbable timeline

AYON Web Viewer demonstrating version comparison. The viewer shows a 3D robot asset. A version dropdown at the top left is set to "Viewing: v004", with a secondary "D v004" and "v003 A" comparison toggle active. The right sidebar shows the status as "Pending review" and includes an emoji-supported activity feed comment regarding version comparison.
Comparing different published versions of a 3D asset in the web viewer.

Comparing Versions

The viewer makes it incredibly easy to compare different versions of the same reviewable. Go to any frame and select the next or previous version. If there's a matching reviewable it will be displayed on the same frame.

We recommend using the two main shortcuts A - previous version and D - next version to quickly flick back and forth between versions.

Comparing Reviewables

Reviewables with the same label across versions will be synced allowing for comparison of two reviewables from different versions.