Push queue priority

Files sent to a push destination with the Push add-on, manually or through auto-push, wait in the push queue until they can be transferred. When many files are waiting, you can decide which of your own pushes go first.

Viewing the push queue

Go to Activity → Workflow manager → Push queue. The overview lists your account's pushes with their destination, status and priority.

The push queue is available to media managers and administrators when the Push add-on is enabled for your account.

How the queue order works

The push servers are shared, so the queue is fair between accounts:

  • Every queued push gets a place in line for your account, in the order it was queued.
  • Your account can run a limited number of pushes at the same time. If your account has many pushes waiting, the next free place goes to another account once you are at that limit.
  • When it is your account's turn, your highest-priority waiting push takes the place.

Priority only changes the order of your own pushes. It never moves them ahead of pushes from other accounts, and it does not make a single transfer faster.

A push that can't start yet, such as a failed push that is waiting to be retried, keeps its place and doesn't hold up the rest of the queue.

Pushes often depend on transcoding, for example when a file's MP4 is pushed or a push waits for its formats. If your videos regularly have to wait in the video queue, dedicated transcoders can be purchased for an additional fee to reduce waiting times. Contact support for the options.

Setting a priority for a folder

To have files from a folder always pushed before (or after) your other files:

  1. Right-click the folder and choose Transcode settings.
  2. Under Queue settings, set Push priority to Low, Normal, High or Urgent.
  3. Click Save.

The priority applies to subfolders too, unless a subfolder has its own priority. Choose Same as parent folder to remove a folder's own priority again. Push priority is only shown when the Push add-on is enabled.

The priority is set when a push is queued, so changing it only affects pushes queued after saving. Pushes that are already waiting keep their current priority; use the prioritize button for those.

See Folder transcode settings for the other settings in this window.

Prioritizing a single push

  1. Go to Activity → Workflow manager → Push queue.
  2. Click the Prioritize button on the row of the waiting push.
  3. Confirm to move it to the top of your queue.

Only pushes that are still waiting can be prioritized.

Using the API

Integrations can do the same through the MediaLab API:

  • PUT /api/folders/{folder_id}/queue_priority sets the push (and transcode) priority of a folder.
  • PUT /api/push/queue/{push_queue_id}/prioritize moves a waiting push to the top of your queue.

These methods require a media manager or administrator. See the API methods for full details.

References