···

    Review branch changes

    Who can review branches

    Only people with an editor role in an organization or workspace can access the branching feature.

    Anyone with can view or can edit access to the branch can review changes.

    Anyone with can edit access to the main file can merge branches.

    This article covers one step in the branching process:

    Create → Share → Update → Request → Review → Merge → Manage

    Branch creators can request a review from a team member or other collaborator before merging a branch. You'll receive an email and notification when someone adds you as a branch reviewer.

    Reviewers can view all the changes included in the branch. They can then choose to Approve a branch, or Suggest changes from the branch's creator.

    If you only have view access to the main file, you can still review a branch. If you have edit access to the main file, you can also merge an approved branch.

    Open branch

    • Click the notification or open the link from your email to access the branch's Branch review modal. In app notification for review request
    • Open the branch you want to review, click the menu next to the file/branch name in the toolbar, and select Review and merge changes. Email notifictaion for review request

    Review changes

    Branch reviews apply to all changes in a branch. There isn't a way to approve some changes and reject others.

    You can use the review process to suggest changes to the branch creator. They can then make those changes and resubmit the branch for review.

    1. In the left sidebar of the Branch review window you can see a summary of the branch. This includes the branch name, the main file, and the total number of changes.
    2. View details of the review request in the Review request section. This includes a description of the branch added by the branch creator, and the date and time the review was requested.
    3. In the main body of the window you can view a list of components, instances, or layers that have been , , , or . Figma groups changes by page, click the page name to collapse or expand the changes in each page.
    4. Select an object or page to view changes for a specific layer or component.

    Branch_review_summary.png

    With a layer or component selected you can:

    1. View the layer, frame, or component name at the top of the modal. Click in the top left to go back to the review summary.
    2. View changes side by side or as an overlay.
    3. Use the buttons to:
      • Zoom in
      • Zoom out
      • Zoom to Fit
    4. View details of the changes, including any layers or specific properties changed.
    5. If there are multiple changes, use the and arrows at the bottom to view other changes.

    Branch review showing design before and after

    Approve branch

    If you're happy with all of the changes you can approve the branch. If you have edit access to the main file you can also merge the branch into the main file.

    To add your approval:

    1. Click Add your review in the bottom-right corner of the window.
    2. In the Finish your review dialog, select Approve.
    3. Add any comments you want to make (optional).
    4. Select Submit to approve the branch. You'll see an Approved badge next to the branch name in the toolbar.

    Finish your review modal with approved selected

    Suggest changes

    If there are changes you'd like the branch creator to make before merging, you can suggest changes. You can add a summary of the changes during the review process.

    If there are specific changes or suggestions you'd like to make, you can also add comments to the individual designs. Comments are specific to the branch and aren't included when you merge the changes into the main file.

    1. Click Add your review in the bottom-right corner of the window.
    2. In the Finish your review dialog, select Suggest changes.
    3. Add any general comments you want to make (optional). You can also close out the modal and add comments to designs or layers in the branch.
    4. Select Submit add your review. You'll see a Changes suggested badge next to the branch name in the toolbar.

    Finish your review modal with suggest changes selected

    Edit review

    Edit your review to make changes to your comment. If you've made a mistake or want to change your review, you can review the branch again.

    1. Click next to the branch name in the toolbar.
    2. Select Review and merge changes.
    3. Find your review in the left sidebar. Click next to your name.
    4. You'll see a blue border around the comment to show the field is now editable. Click inside the text and make any changes as needed. Click outside the text field to apply your changes.

    Edit_review_comment.png

    Review again

    If you've made a mistake or want to change your review, you can review the branch again. You can also use this process to review a branch after your suggested changes have been made by the branch creator.

    1. Click next to the branch name in the toolbar.
    2. Select Review and merge changes.
    3. Click Review again at the bottom of the modal.
    4. Select from Approve or Suggest changes.
    5. Add a comment if needed (optional).
    6. Click Submit to add your review.

    Related Videos