What is a change request

A change request is a set of changes to one space that people review before the changes go live. Readers see the live pages until someone merges the change request.

One change request can add, edit, rename, move and delete many pages in the same space. While you work on it, the change request holds your changes. The live pages do not change.

A change request in review, with its status, author, description and changed pages

States

Each change request has one status.

Status	What it means
`Draft`	You are still making changes. Only you can see it.
`In Review`	You submitted it. It waits for a reviewer.
`Changes Requested`	A reviewer sent it back with feedback. You can edit it again.
`Approved`	A reviewer approved it. It is not live yet.
`Merged`	Someone merged it. The changes are live.
`Rejected`	A reviewer rejected it. It cannot be merged.
`Archived`	The author discarded it.

stateDiagram-v2
    state "In Review" as In_Review
    state "Changes Requested" as Changes_Requested
    [*] --> Draft
    Draft --> In_Review: Submit
    In_Review --> Draft: Withdraw
    In_Review --> Approved: Approve
    In_Review --> Changes_Requested: Request changes
    Approved --> Changes_Requested: Request changes
    Changes_Requested --> In_Review: Submit
    In_Review --> Rejected: Reject
    Approved --> Rejected: Reject
    Approved --> In_Review: Edit after approval
    Approved --> Merged: Merge
    Draft --> Archived: Discard
    Changes_Requested --> Archived: Discard
    Merged --> [*]
    Rejected --> [*]
    Archived --> [*]

Merged, Rejected and Archived are final. A change request in these states cannot be edited or reopened. To try again after a rejection, start a new change request.

Who can do what

Your access to the space decides what you can do. See Who can read and write and Roles and permissions.

Status	Author	Reviewer (Write access)	Other readers
`Draft`	Edit, submit, discard	Cannot see it	Cannot see it
`In Review`	Edit, withdraw	Edit, approve, request changes, reject, assign a reviewer	View the changes
`Changes Requested`	Edit, submit again, discard	View the changes	View the changes
`Approved`	Edit (goes back to `In Review`)	Merge, edit, request changes, reject, assign a reviewer	View the changes
`Merged`, `Rejected`	View	View	View
`Archived`	View	Cannot see it	Cannot see it

A Wiki Manager can see and act on every change request.

Wiki

States

Who can do what

Next steps