Record decisions in Notebooks

Using reviews and decisions together makes it easier to gather feedback on your work and keep your teams updated on milestones.

  • Requesting a review in a notebook is a great way to review designs, gather clear feedback, discuss alternatives, and take action as a team.
  • Marking a decision lets you condense the feedback into a single outcome that moves your work forward.

Decisions give your team clarity on what was approved in a review and help you to track how the work evolved across multiple reviews and decisions. You can also use decisions to document feedback and milestones gathered outside of Notebooks.

Each decision you mark in a notebook creates a decision block at the top of the page. By default, only the most recent decision is shown. If there are multiple decisions, you can click View all to expand the block. You can see a count of the total number of decisions next to the section title, which lets you know that there are more decisions to view.

A decision includes:


  • Decisions section title and counter
  • Flag icon indicating that it is a decision block
  • Name of the decision
  • Creator (or editor) of the decision and a timestamp
  • Overflow menu to access additional options
  • Show/hide description arrow
  • “View all” option

If desired, you can include a description of the decision to provide details about it. This description is hidden by default; click the arrow to the far right of the decision block to view it. If there is no arrow on the block, the creator did not include a description.

Add a decision to a notebook

Decisions can only be created by contributors, but can be seen by all users.

To mark a decision in a notebook:

  1. Navigate to a notebook where you want to mark a decision.
  2. Click Add decision.
  3. In the modal, write a decision title (required) and description (optional).
  4. Click Save decision.

Edit or delete a decision block

We all need a do-over sometimes. Maybe your team changed their mind; maybe you need to edit a few words for clarity. Whatever your reason, it's simple to edit or delete decision blocks in Notebooks.

There's no limit to the number of decision blocks you can leave on a notebook. Because of this, even if a decision is changed, it can be helpful to leave it on the record for context and add a new decision regarding the update. Work with your team to develop documentation around when it's appropriate to edit or delete a decision and when it's better to leave an old decision on the record.

Edit a decision block

To edit a decision block:

  1. Navigate to the notebook where you want to edit a decision block.

  2. On the decision, click the More options icon.

  3. Choose Edit.

  4. Make your desired changes.

  5. Click Save decision.

Your edits appear immediately.

Delete a decision block

Only certain people can delete a decision: the person who created the decision, the notebook owner, and contributor admins.

To delete a decision block:

  1. Navigate to the notebook where you want to delete a decision block.

  2. On the decision, click the More Options icon.

  3. Choose Delete.

  4. Confirm your decision to permanently delete the notebook decision by clicking Delete.

Notebooks deletes the decision.