Publishing states

The Publishing Queue provides feedback about the status of a publish action. A publish state indicates the stage in the publish transaction. A publish transaction is an individual package that is being published. One publish action, (for example, republishing a Component) may result in several publish transactions if the publish action results in the Component being published on more than one Page.

The state of the publish transaction changes when it is scheduled, put in the message queue, in progress by the publisher or is finished/failed:

  • Scheduled for publish
  • Scheduled for deployment
  • Waiting for publish (queued)
  • Waiting for deployment
  • In progress (processed by the publisher service, transport service, or Deployer)
  • Throttled
  • Success
  • Warning
  • Failure

You can view the publish state of a publish transaction by viewing the Publishing Queue. For more information, refer to Viewing and filtering the Publishing Queue.

The state of a publish transaction is based on the stage in the publishing process that has started. The following table shows the stage of the publish transaction and the corresponding state when the publish time is immediate.

StepDescriptionPublish transaction status
1A User publishes an item. The Content Manager resolves the Publication Targets and creates a Publish Transaction for each combination of Publication and Publication Target.Waiting for publish
2The publisher picks up the publish transaction from the queue and renders and resolves the item.In Progress
3The Transport service sends rendered information and metadata to the Content Deployer with a Deploy command.

If the transport cannot be completed because there are more items waiting to be deployed than the configured window size, the status is set to Throttled. The publisher will continue to offer its transport package to the Content Deployer until the status returned is something other than Throttled.

If the transport is not successful, the status is set to Failed.

If the transport is successful, but errors occurred while generating publishable content, the status is set to Warning. This can only occur if the Publish/Unpublish option "Ignore failures while generating publishable content" is selected.

If the transport is successful, the status remains In Progress.

4The Content Deployer deploys the content.If the deploy is not successful, the status is Failed.

The following table shows the stage of the publish transaction and the corresponding state when the publish time is scheduled.

StageDescriptionPublish transaction state
1A User publishes an item. The Content Manager resolves the Publication Targets and creates a Publish Transaction for each combination of Publication and Publication Target. The Content Manager schedules the publish action.Scheduled
2The scheduled render time arrives. The Content Manager sends the item to the Publisher.Waiting for publish
3The publisher picks up the publish transaction from the queue and renders and resolves the items.In progress
4The transport service sends the rendered information and metadata to the Content Deployer with a wait command.Waiting
5The deploy command is scheduled.Scheduled for deployment
6The scheduled deploy time arrives.Waiting for deployment
7The publisher retrieves the publish transaction from the queue.In progress
8The Transport Service sends rendered information and metadata to the Content Deployer with a Deploy command.

If the transport cannot be completed because there are more items waiting to be deployed than the configured window size, the status is set to Throttled. The publisher will continue to offer its transport package to the Content Deployer until the status returned is something other than Throttled.

If the transport is not successful, the status is set to Failed.

If the transport is successful, but errors occurred while generating publishable content, the status is set to Warning. This can only occur if the Publish/Unpublish option "Ignore failures while generating publishable content" is selected.

If the transport is successful, the status remains In progress.

9If the transport was successful, the Content Deployer deploys the content.If the deploy is successful, the status is Success. If the deploy is not successful, the status is Failed.