Request a diagram for a page

Diagrams are available only where this feature is turned on for your workspace. If you don't see Suggest a diagram on a page, the feature isn't enabled for your workspace.

The page must already be watched and mapped to a repo. See Mapping pages to repos for how to watch a Notion page.

  1. Open the Notion page you want a diagram for from the Pages screen.
  2. Select Suggest a diagram.

Amendary reads the page and its mapped repo, designs a diagram, checks the labels and connections against the supplied code before rendering it, and produces an SVG. While this is in progress, the page shows Designing….

The proposed diagram always lands in the Queue for review, it is never added to the page automatically. The page's diagram status shows In the Queue until you act on it.

<aside> ✏ A proposed diagram is held for review in every case, regardless of your workspace's review mode. See Turning on automatic corrections for how review mode works for text corrections; it does not apply to diagrams.

</aside>

Review the proposal

Diagram proposals appear in the Queue alongside other corrections, with their own card showing Proposed diagram, the evidence used to design it, and the repo it was built from. Select Open SVG to see the full image before deciding.

See Reviewing corrections in the Queue for the full review workflow, including evidence and editing.

<aside> ✏ If the SVG preview doesn't load, reload the card to try again.

</aside>

Diagram status on a page

Each diagram tracked for a page shows one of these states:

Status What it means
Not designed No diagram has been requested for this page yet.
Designing… A proposal is being generated.
In the Queue A proposal is ready and waiting for your review.
Adding… An approved diagram is being written to the page.
Not on the page The diagram was removed from the page, or was never added.

<aside> ⚠ If the page was edited after a diagram was added, the page shows a notice that the diagram may no longer match the page's current content. Review the diagram against the page before relying on it.

</aside>

Remove a diagram

You can remove a diagram you no longer want, whether it's still pending or already on the page.