Platform Administration and Architecture

Enable or disable publishing deep scan

Abstract

How to enable and disable deep scan of related items when publishing single item.

Applies to

Content Management

When you publish a single item you can choose to publish related items at the same time. Examples of related items include a media item, a drop-down field selection, or the item's data template. The publishing process uses the Link database to look up references from the item being published. The deep scan setting determines if related items are published recursively (related items of related items):

  • If deep scan is enabled, related items are published recursively. Deep scan is enabled by default.

  • If deep scan is disabled, only directly related items are published.

You can disable deep scan to reduce the number of publishing operations and improve performance.

Important

The deep scan setting does not apply if you are using the Content Publishing service.

Disable deep scan in Sitecore 9.1 and earlier

To disable deep scan in Sitecore 9.1 and earlier, patch the /App_Config/Sitecore.config configuration file by adding a <DeepScan> element with a false value to the AddItemLinkReferences pipeline as shown:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
<sitecore>
        <pipelines>
            <getItemReferences>
                <processor type="Sitecore.Publishing.Pipelines.GetItemReferences.AddItemLinkReferences, Sitecore.Kernel">                   
                    <DeepScan>false</DeepScan>
                </processor>
            </getItemReferences>
        </pipelines>
    </sitecore>
</configuration>

Disable deep scan in Sitecore 9.2 and later

To disable deep scan in Sitecore 9.2 and later, patch the Publishing.DeepScanRelatedItems setting as shown:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <sitecore>
        <setting name="Publishing.DeepScanRelatedItems" value="false"/>
    </sitecore>
</configuration>