Troubleshoot Publishing Issues

When an Content Author edit or create item in Sitecore,  it must be published to an publishing target and content will be shown on website from the publishing target only. However, during the publishing operation, some of the items may not be published to the publishing target due to various restrictions which the Content Author may not be aware of.

So when items are published in Sitecore, the items are evaluated using the below rule-set in order to determine whether to publish an item to publishing target(s) or not.

  • Item Level Checks: if any of the below item level validation fails, then the items and all of its descendants will not be published to publishing target(s).
  1. Is the Item is Publishable?
  2. Is the Item’s Publishing Date has reached?
  3. Is Item’s Unpublishing Date has reached?
  4. Is the Ancestor Item is Publishable?
  5. Is the Ancestor Item Publishing Date has reached?
  6. Is the Ancestor Item Unpublishing Date has reached?
  7. Is the Ancestor Item available in Web Database?
  • Item Language Version Specific Checks: if any of the below Item Language Version Specific check fails, then the  version of the item on the selected language(s) will not be published to the publishing target(s).
  1. Is the Item having required Language Version?
  2. Is the Item has valid Language Version?
  3. Is Item in Final Workflow State?

Note:

Publishing restrictions let you specify that a specific item or a version of an item is publishable or unpublishable, either within a specific date range or indefinitely.

And also we can set Publishing restrictions on Publishing target as well, then the item will be published to selected Publishing targets only.

 Item Level Checks:

Publishing Settings_Item

The Item Level Checks is applicable for all the language version of the item. If any of the above mentioned item check fails when publishing a specific item, then any versions of that item or any of its descendants will not be published to Publishing target(s).

When publishing a specific item, It will check whether the specific item is Publishable, “Publishing from” date is reached and “Publishing to” date is not yet reached. And also the same check will be performed for all the ancestor items of the item, if any of the ancestor item is failed on the validation, then the item will not be published.

It also checks whether the Ancestor item of the specific item is available in target database(s) ,only if the immediate Ancestor item is available in target database(s) then only the child item will be published to Publishing target(s).

Note:

When the “Publishable” checkbox is unchecked and if you publish the Item, then the item and its descendants will be removed from Web Database, if it already exists.

When the “Publishing from” date is not yet reached and if you publish the Item, then the item and its descendants will be removed from Web Database, if it already exists.

When the “Publishing to” date is not yet reached and if you publish the Item, then the item and its descendants will be removed from Web Database, if it already exists.

Language Specific Checks:

Publishing Settings_Version

The Language Specific Checks will be performed for each selected languages during publishing – this is because each language version of the item will have different restriction applied.

On Language Level check, the below validations occur:

  • the Item is having the required Language Version
  • the Item has valid Language Version (only if,  any of the item language version should be  Publishable, “Publishing from” date is reached and “Publishing to” date is not yet reached on the language)
  • the Item in Final Workflow State.

Note:

If Sitecore cannot publish a version of an item, it can still publish the item itself, including its descendants.

The above are some of the restrictions upon which a specific item or a version of an item may not be published to Publishing target(s) . There are some other factor like security permissions, availability of publishing Instance, etc. which may also play a role in successfully publishing items to Publishing target(s).

Based on above identified checks, we have built a module called Smart Publishing Assistant (SPA) which will help to troubleshoot all the mentioned checks and fix them quickly.

More details on Smart Publishing Assistant (SPA) tool can be found here. And you can download the Smart Publishing Assistant (SPA) from Marketplace.

Advertisements

2 thoughts on “Troubleshoot Publishing Issues

Leave a Reply to Gangadharan Cancel reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s