# How to collaborate on change requests

Change requests are GitBook’s way of safely collaborating on documentation — similar to pull requests for code. They let you propose, review, and refine updates before anything goes live.

This video and guide will take you through change requests in GitBook, covering:

* Creating [change requests](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/change-requests) to edit content
* Reviewing edits with [diff view](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/change-requests/change-requests-in-a-space#diff-mode)
* Tracking changes in the **Changes** tab
* [Previewing changes](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/change-requests/change-requests-in-a-space#previewing-a-change-request)
* Merging and publishing your content live

{% embed url="<https://www.youtube.com/watch?list=PLZAlnWDc6FDt4QfYCyjiMgexzTyDfDkdI&v=sU_JbCFUE7k>" %}

{% stepper %}
{% step %}

### Create a change request

Create a **change request** before editing published docs. This keeps your work separate from live content.

If you’re new to the workflow, start with [change requests](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/change-requests).
{% endstep %}

{% step %}

### Make and review edits

Edit content inside the change request, like you normally would. Use [**comments**](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/comments) to leave feedback and collaborate in-context.
{% endstep %}

{% step %}

### Track changes and preview

Open the **Changes** tab (aka [diff view](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/change-requests/change-requests-in-a-space#diff-mode)) to review what’s been modified.

Use [**Preview**](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/change-requests/change-requests-in-a-space#previewing-a-change-request) to see exactly what will ship after merge.
{% endstep %}

{% step %}

### Request reviews (optional)

[Request a review](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/change-requests/change-requests-in-a-space#request-a-review-on-a-change-request) when you need another set of eyes. This keeps the workflow clear and encourages discussion before publishing.

If you need tighter controls, combine reviews with [merge rules](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/merge-rules).
{% endstep %}

{% step %}

### Merge when ready

When everything looks good, click **Merge**. Your changes will go live immediately.
{% endstep %}

{% step %}

### Use merge rules (optional)

Set up **merge rules** to define what must happen before merge. For example, require one or more reviews for approval-heavy teams.
{% endstep %}
{% endstepper %}