Sync Sentry · Documentation

Manage the Revit
sync queue.

A practical Sync Sentry guide for Revit sync management: queue workflow, worksharing monitoring, Synchronize with Central traffic, Request Relinquish, Queue Manager controls, maintenance, and recovery.

User workflowQueue Manager controlsAdmin recovery
SS-Doc_Light.png
Documentation contents

Revit sync management for production use.

For Users

Join the Revit sync queue, wait, request, and sync.

Use Join Queue, Pause Me, Request Relinquish, Follow Queue, Queue Request, and Widget Mode without touching manager-only tools.

For Queue Managers

Manage Revit sync traffic safely.

Add/remove users, pause/unpause rows, drag reorder, repair, clean, reset, and export records.

For Admins

Maintain and recover the Revit sync queue.

Add/remove Queue Managers, use User History recovery, and use SHIFT+Reset only when current-model shared queue files need a hard reset.

SetupRevit sync queue setup and model scope
Supported workflow

Open a live workshared network central model, then launch Sync Sentry from the BIMGrove ribbon. Sync Sentry scopes the Revit sync queue to the current central model so users working in the same model see the same queue and can coordinate Synchronize with Central traffic.

  • Revit 2023, 2024, 2025, 2026, and 2027 are supported.
  • Network central models are supported in this public release.
  • BIM360/ACC/Forma cloud models are marked Not Supported for this release.
Project UsersRevit sync monitor and Project Users
Columns and row behavior

The Project Users table is the primary Revit sync monitor in Sync Sentry. It stretches to the console width; the # column stays fixed at 40 px, and the remaining space is split across User, Status, and Request.

ColumnPurpose
#Queue position. The header tooltip reads Queue Position.
UserUser display name. Follow Queue Once turns the text guava. Follow Queue Always turns it guava and italic.
StatusWorking, Idle, Paused, Next Up, Syncing with progress percentage, or waiting on a Revit dialog.
RequestQueue request state such as Sent, Accepted, Wait, or Cancelled.
Idle detection

Idle is based on Revit document/view activity for the current model. General Windows mouse or keyboard activity does not reset the status. After 5 minutes with no Revit document activity, the row can show Idle.

ActionsRevit sync and relinquish actions
Action map
RoleActionsNotes
All UsersFollow Queue Once, Follow Queue Always, Unfollow, Queue Request.Used for Revit sync coordination and relinquish requests without manager rights.
Queue ManagersAdd to Queue, Force Sync, Remove from Queue, Pause Queue, Unpause Queue, drag reorder, Repair Queue, Clean Queue, Reset, exports.Queue Manager rights are configured in Sync Sentry security settings.
AdminAdd/Remove Queue Manager, Force Close Dialog, Force Launch Project from User History, SHIFT+Click Reset.Admin-only actions are protected by security configuration.
MaintenanceRevit sync queue maintenance
Buttons and reset levels
  • Refresh: available to all users. Reloads status and queue state without force-cleaning active users.
  • Repair Queue: Queue Managers/Admins. Repairs duplicate, invalid, or stale queue rows while protecting active sync.
  • Clean Queue: Queue Managers/Admins. Clears waiting or paused queue rows while protecting the active syncing user.
  • Reset: Queue Managers/Admins. Combines safe queue repair with Project Users presence reset.
  • SHIFT+Click Reset: Admin only. Exports history first, then hard-cleans current-model Sync Sentry token/action files and local AppData cache while preserving user_settings.json and security settings.
Widget ModeWidget Mode and Revit sync history
Compact monitoring

Widget Mode provides a smaller Revit sync monitor with the same theme-aware Project Users styling. Use it when you want to monitor queue state and sync traffic while preserving Revit screen space.

Status, Sync History, Action History, User History

The review area shows current queue status, sync history, action history, and user history. User History supports Admin recovery actions such as Force Launch Project when the target Agent is online.

LicensingLicensing and limits
Personal and paid plans

Personal mode allows 7 successful Join Queue actions per day. Trial, Pro, Studio, Gratis, and Early Access licenses do not have the join-queue limit. Join Queue counts are consumed only after a successful queue write.