Syncing Playlists and Notes with ShotGrid

Viewing ShotGrid Playlists in SyncSketch

Once we have received the script user information and updated your workspace, you will be able to browse ShotGrid Playlists within SyncSketch.  

Note: Your information will be stored securely in our database using a PBKDF2 algorithm with a SHA256 hash, as recommended by NIST


First, choose which Projects in your Workspace that you will use with your ShotGrid playlists. 

To do so, open the Workspace Settings to the Projects tab.  Toward the right-hand end of the Project's row in the list is a ShotGrid Project dropdown:

Select your ShotGrid project, then click on the SyncSketch Project's Name at the left-hand end of the row to open the SyncSketch Project.

Within the project, you will find the ShotGrid Sync dialog by clicking on the ShotGrid button in the upper right.


The ShotGrid Sync dialog allows you to browse your ShotGrid playlists. This list will include all playlists active within the last 60 days. Press the Sync button for the playlist to appear as a Review in your SyncSketch project.  The sync process will display a progress bar for better feedback.


Once a review is synced, it will show up in your SyncSketch Reviews Tab. Reviews which are connected to ShotGrid have the SG button near the middle of the row. The menu that appears will allow you to refresh the playlist items, in case there were some last minute changes to the Playlist on the ShotGrid side.  

Once you made sure all Versions have been synced, your team can start adding notes in SyncSketch in a synced session or offline.

While in the Review, you can find the familiar ShotGrid button toward the right-hand end of the upper toolbar in the Review Player.

Pushing Notes back into SG

After users have given their notes on SyncSketch, you can push the information back to ShotGrid using the same menu.  In the SG menu, use the Push Notes to ShotGrid option which will start sending the notes to the ShotGrid Playlist. Both Comments and Sketches will be stored in a single Shotgun Note to prevent confusion. (It is not uncommon to have more than 20 Sketches per version which would make it hard to track on the ShotGrid side.) 


Confirmation dialog after the Sync.


After the Notes have been synced, they will show up in your ShotGrid interface. You can see that the Comments have been added with Markdown for the frame numbers and the Sketches are attached as frame accurate annotations. The generated note is connected to the Playlist, the Shot and the Version to make sure it's easy to find. 


We included a shortened URL back to SyncSketch for quick access of the notes in context.


This is the ShotGrid Plugin in a nutshell. If you have any questions or suggestions on how to improve the communication between ShotGrid and SyncSketch, please get in touch

Sort Order

To ensure that the sort order between ShotGrid and SyncSketch match, use the ShotGrid field sg_sort_order for sorting.