Restoring Salesforce Knowledge Articles Overview

Knowledge articles can be backed up and restored to protect against data loss and corruption. You can restore Knowledge articles to recover an entire article or its draft version, and fix corrupted content or publication status.

By default, Knowledge Articles are excluded from backups. To enable backing up and restoring Knowledge Articles, the following conditions must be met:

  • Lightning Knowledge must be enabled in your org to enable backup of Knowledge Articles.
  • A user must have the View Articles permission enabled.
  • Salesforce Knowledge users, unlike customer and partner users, must also be granted the Knowledge User feature license.
  • Multiple Languages must be enabled, in the Knowledge Settings of Salesforce Setup.

About Knowledge Articles

Knowledge Articles in Salesforce are special objects. Restoring Knowledge Articles is different from restoring other objects into Salesforce.

The Salesforce parent object for Knowledge Articles (*__ka) cannot be used for backup, as it is only the metadata of the knowledge article. From this object, other versions can be derived - KnowledgeArticleVersions and their associated *__kav objects - where the data from the Salesforce Knowledge article is replicated, and backed up.

Knowledge Article Status and Versions

When a knowledge article is backed up, Own creates versions of the article, where the data is replicated.

There are three publication status types for any given knowledge article:

  • Draft - Only one draft version can exist (at a time) for any article, for any given language.
  • Published - Only one published version can exist (at a time) for any article, for any given language.
  • Archived - Multiple archived versions can exist simultaneously for any article (for any given language).
    Note
    Note Archived versions of the knowledge article can not be restored to Salesforce, only draft and published versions can be restored.

Data Loss or Corruption

There are three possible scenarios for data loss or corruption:

  • Data loss (entire article) - An entire knowledge article was deleted - the article was lost, along with all of its versions (drafts, published, and archived). When restored, the entire object will be restored as it was backed up, except for archived versions or any image files (which are not supported by the backup).
  • Data loss (draft version/s) - One or more drafts were lost (multiple draft versions can be deleted, one draft per language). The restore procedure will overwrite any existing drafts, if they exist.
  • Data corruption - Version content was changed, or publication status of Version was changed (e.g. A draft was published, or a published article was archived, or a draft was published and then archived). The restore procedure will overwrite any existing drafts, if they exist.

Restoring Lost Data

In order to restore Knowledge Articles, we need to create new versions of each article. When data corruption occurs in a Salesforce knowledge article, the data can be restored from the replicated object versions in Own (from the *_kav objects).

Other Considerations

Since only one published version and only one draft version of an article (for any given language) can exist at any one time, then all other versions of the article are archived. There can be numerous versions of the article in Archive state. However, the Archive article versions cannot be restored back into Salesforce. Only published versions and draft versions (for any given language) can be restored to Salesforce.

Since only one draft version can exist (for any language) at any one time, when a new draft version is created, it overwrites the previous draft version of that article. Therefore, you need to be aware that when creating a new draft version of an article (for example, when editing an existing draft), then the previous version of that draft will no longer be available.

The same applies to the published version of an article. Since only one published version can exist (for any language) at any one time, when a draft version is published, it overwrites the previously published version of that article (for the given language). Therefore, you need to be aware that when publishing a draft version of an article, then the previous version of that published article will no longer be available. To preserve the previous version of the published article, before publishing a new version, you must first archive it (create an Archive version of that published article).

Note
Note When restoring a draft version, the existing draft version (of the same language) will be overwritten.

Beware that if you manually back up a Salesforce org after data corruption has occurred in a knowledge article, then the knowledge article with corrupted data might replace a previously backed-up knowledge article object that may have had uncorrupted data.

Remember that when a draft version is published, then the existing published article version is overwritten by the new published version.

In Salesforce, performing a “Restore” on an archived article, converts it to a draft version. The draft version can then be restored. Keep in mind that this action will also overwrite any existing draft version, since only one draft version can exist at a time (for a given language).

Note
Note Archived versions of the knowledge article can not be restored to Salesforce, only draft and published versions can be restored.
Note
Note The Nodes template supports the seeding of knowledge articles. You are required to add the *_kav object as a root node in the Nodes template.
Note
Note Knowledge Articles in all languages are supported by the Backup and Restore application.
  • Restore Salesforce Knowledge Article Versions
    Recover lost data when you restore deleted or corrupted knowledge articles. Find discrepancies by comparing article versions and then restoring specific articles to help maintain continuity and knowledge integrity within your organization.