Changing the status of a knowledge article
Status type
The following information applies to all review statuses:
- Only the assigned reviewer and Knowledge Admin can update an article.
- Members from the reviewer's support group can assign an article to themselves.
- Reviewers can add an update request and edit an article.
The following table provides a description of article status types.
Status type | Description |
---|---|
In Progress | Initial status that is automatically assigned to all articles at the time of creation. Articles are visible only to the author until they are promoted to Draft status. The author can update and save the article an unlimited number of times before highlighting it. |
Draft | The first status in the workflow. The author promotes articles to this status after creating the article. Draft articles contain content that has not undergone a formal review or has not been approved. Articles with this status are designated for internal use by Support only, and are not accessible to external users, also known as Self Help users. |
SME Review | Typically the next step after Draft. The SME Reviewer reviews and optionally edits the article, and can promote it to one of the following statuses:
|
Optional Review 1 | Additional, optional review status that is subsequent to the SME Review status. A reviewer reviews and edits the article, and promotes it to either an additional review of a different type or to Publish Approval status. By default, Optional Review 1 is intended for technical content review. Note: The name of this status is configurable. |
Optional Review 2 | Additional, optional review status that is subsequent to the SME Review or Optional Review 1 status. A reviewer reviews and edits the article, and promotes it to Publish Approval. By default, Optional Review 2 is intended for proofreading. Note: The name of this status is configurable. |
Publish Approval | Mandatory status before being Published. The article is sent for approval pending publication. Best practice: Change the initial settings of automatic approvals to manual approvals and set up approvers for the approval process, otherwise it will result in continued automatic approvals. Changing the settings and not setting up approvers will result in the failure of the approval level processes. For more details on configuring approval processes and approvers, see Configuring-approvals. |
Published | The article is published and becomes available to all users. Note: Self help users can view only Published articles, if the articles are not marked for internal use only. |
Retire Approval | Mandatory status before being Retired. The article is sent for approval pending its retirement. Note: We recommend that you change the initial settings of automatic approvals to manual approval and set up approvers for the approval process. Not changing the initial settings will result in continued automatic approvals. Changing the settings and not setting up approvers will result in the failure of the approval level processes. For more details on configuring approval processes and approvers, see Configuring-approvals. |
Retired | The article is no longer relevant for use but remains searchable. |
Closed Version | An earlier version of an article that is not searchable. This status is automatically assigned when a new article version is created and becomes Published. |
Cancelled | The article is no longer usable or searchable, however, it is not deleted from the database. Cancelled status is displayed as an item on the Status drop-down list to Knowledge Admin users only. Administrators can also filter for cancelled articles in the KM Console. For more information, see How-knowledge-articles-are-found. This status can be set from any other status (for example, Draft). The exception to this rule is that Published articles can never be promoted directly to Cancelled status, and Knowledge Users must first send a Cancellation Request for approval. For more information, see Cancelling-a-knowledge-article. |
Status group
The following table presents a description of the status types and divides them into the following groups:
- Article status group — Group containing either Published or Not Published articles. Also see How-knowledge-articles-are-found.
- Status bar group — Group of similar statuses that is displayed on the status bar.
Article status group | Status bar group | Status type |
---|---|---|
None | In Progress | In Progress |
Not Published | Draft | Draft |
In Review | SME Review | |
Optional Review 1 | ||
Optional Review 2 | ||
Publish Approval | ||
Published | Published | Published |
Retire Approval | ||
None | Closed | Closed Version |
Retired | ||
Cancelled |
Status transition
The following table presents the pre-configured default status transition workflows that are available in accordance with user roles and permissions. Status transitions are configurable parameters and you can customize them, as required.
Status From/To | In Progress | Draft | SME Review | Optional Review 1 | Optional Review 2 | Publish Approval | Published | Retire Approval | Retired | Canceled | Closed Version |
---|---|---|---|---|---|---|---|---|---|---|---|
In Progress |
| x |
|
|
|
|
|
|
|
|
|
Draft |
|
| x | x | x | x |
| x |
|
|
|
SME Review |
|
|
| x | x | x |
| x |
|
|
|
Optional Review 1 |
|
| x |
| x | x |
| x |
|
|
|
Optional Review 2 |
|
| x | x |
| x |
| x |
|
|
|
Publish Approval |
|
|
|
|
|
| By approval |
|
|
|
|
Published |
|
|
|
|
|
|
| x |
|
|
|
Retire Approval |
|
|
|
|
|
|
|
| By approval |
|
|
Retired |
|
|
|
|
|
|
|
|
|
|
|
Cancelled |
|
|
|
|
|
|
|
|
|
|
|
Closed Version |
|
|
|
|
|
|
|
|
|
|
|
When an article is in the Publish Approval or Retire Approval status, user can request a cancellation of the Publish Approval or Retire Approval process. This reverts the article status back to the Draft or Published status. If a draft has a previously published version, only the draft version is retired. If the published version is requested for retired-approval, a message is displayed that states that the draft must be deleted first.
When you change the status of an article from In Progress to Cancelled, the article is deleted. You can use this option to delete an article that is created mistakenly and not needed anymore.
To change the status of a knowledge article
If you are an authorized author and reviewer, you can select the new status and save the article.
You can change an article's status in the following locations:
- Status transition bar in the header section of the knowledge article
- Status field on the Details page of the knowledge article.