Publish an item to your website

Current version: 10.1

When you are ready to publish an item to your website, you can run the publishing wizard, which guides you through the steps of publishing in Sitecore. You can run the publishing wizard from the Content Editor and the Experience Editor.


If you publish a new child item individually, the associated parent item must be published first.


Before you publish, you can set up a verbose logging process for troubleshooting, to understand which items got published and why.

To enable logging for every item version that is published, create a patch file that uses the traceToLog setting in the UpdateStatistics processor of the publishItem pipeline:

	         <publishItem help="Processors should derive from Sitecore.Publishing.Pipelines.PublishItem.PublishItemProcessor">
            <processor type="Sitecore.Publishing.Pipelines.PublishItem.UpdateStatistics, Sitecore.Kernel" runIfAborted="true">

When traceToLog is set to true, publishing information is logged and available in the log file.

An example log record:

6584 11:19:00 INFO  ##Publish Item: Name=A content item, Uri=sitecore://master/{EF687BD4-3C0D-4121-8B63-C7B602DF3213}?lang=fr-FR&ver=1, Operation=Updated, ChildAction=Skip, Explanation=Version 'fr-FR_1' was published.

These are the available log details:

  • Operation - the publish action taken on a publishing candidate (target item). Possible values are skip, update, create, or delete.

  • ChildAction - the publish action taken on child items. Possible values are skip, allow, or force.

  • Explanation - a description of the publishing status, such as whether an item was published and some details.

Publish an item

To publish a single item:

  1. Open the Publish Item wizard from one of two locations in Sitecore:

    • From the Content Editor – select the item that you want to publish. On the Publish tab, in the Publish group, click the Publish drop-down arrow, and select Publish item.

      The Publish menu on the Content Editor ribbon

    To publish the selected item in all languages to all publishing targets and avoid going through the steps of the publishing wizard, click Publish .

    • From the Experience Editor – navigate to the page that you want to publish, and on the Home tab, in the Publish group, click Publish.

      The Publish button on the Experience Editor ribbon
  2. In the Publish Item wizard, on the Settings page, specify the publishing mode:

    • Smart publish – publishes the selected item if it has changed since the last publication. When you run Smart Publish, the selected item in the Master database is compared with the equivalent item in the target database and, if the item has changed, it is published. When you are publishing single items, Smart Publish is a quick way to make sure that all changes to a specific item and its subitems are published.

    • Republish – publishes everything. Republish overwrites the selected item in the target database with the equivalent item from the Master database – even if it has not changed. In this way, all obsolete versions are removed from the target database. You can use republishing to restore a backup of the master database and to add a new content language, a new publishing target, or other system items.

      The Publish Item dialog box
  3. To publish all the subitems of the selected item, select Publish subitems.

  4. To publish all the related items to the selected item, select Publish related items. It is generally recommended that you select this option. Related items can be:

    • Clones – items that are clones of the selected item.

    • Media items – media items that are referenced by the selected item.

    • Content items - data sources that are referenced by the selected item.

    • Design items - renderings, layouts and templates used by the selected item.

    • Aliases – items that are aliases of the selected item.


    By default, the publishing mechanism uses the deep scan approach for identifying which items to publish.

  5. In the Publishing language section, specify the language versions that you want publish.

  6. In the Publishing targets section, specify where you want to publish the items to.


    If you do not specify a publishing target, the item is published to all the publishing targets.

  7. Click Publish. When the publishing completes, you can see how many items were processed during publishing and the number of items that were created, deleted, or updated on the target database.

    The Publish Item dialog box after publishing

An administrator can patch the configuration and set the Publishing.DeepScanRelatedItems setting to false:

<setting name="Publishing.DeepScanRelatedItems" value="false" />

When you specify this setting as false, Sitecore does not scan for all possible changes in the related items of the published item. This means that Sitecore publishes fewer items and publishing is therefore faster, but possibly less complete.

This setting is not visible, and the default value is true.

Do you have some feedback for us?

If you have suggestions for improving this article,