Machinations

Public Diagrams

3 min read

Tip

Share a public link with anyone on the web without the need for them to create an account.

This feature requires your account to be set to Private. You can change it with the Private profile switch on your Profile page, or follow the on-screen instructions.

Check out the public link created in the example above (open in your Google Chrome Incognito Mode if you already have a Machinations account).

Note

Anyone with the link will be able to:

  1. Play the diagram (continuously or step by step)
  2. Choose what parameters to plot
  3. Navigate through simulations
  4. Open in my Machinations button (copies the diagram to your own account)

Embed the model

Any public diagram can be embedded in a web page, a wiki, a document or a presentation tool, and any site may show it. Open the diagram, open the Share menu at the top right of the editor and choose Embed model.

The Embed model window shows a live preview of exactly what your readers will see. You choose what goes into it:

  • Levers: pick up to five Levers that readers can move. If the diagram has a description, it shows under the Levers.
  • Scenarios: pick up to two of your saved scenarios. Readers get one tab for each, next to a Yours tab.
  • Result card follows: pick the node whose value the results card reports.
  • Theme: Visitor’s follows the light or dark setting of whoever is reading, or you can fix it to Light or Dark.

The window then gives you two things to copy:

  • Copy embed code copies an <iframe> and a small script (/embed.js). Paste both into your page. The script sizes the embed to exactly the height it needs, so it never shows a scroll bar, and its width follows the column of your page. Without the script the embed fills whatever height the iframe is given.
  • Copy embed link copies the address of the embed on a page of its own. Use it where a tool asks for a link rather than HTML, such as Notion’s Embed block.
Note

You do not need to set a width or a height. The embed sizes itself. Changes you save to the diagram show up in the embed.

What readers can do in an embed

An embed is a small, ready-to-use version of your model. Readers see:

  • the diagram’s title, with an (i) that explains the model;
  • the Levers you chose, which they can move;
  • a tab for each scenario you chose, next to Yours, where their own Lever settings live;
  • the diagram, which plays along as they Play;
  • a results card that compares each Play with the previous one;
  • the Playbar, to Play the model;
  • Share, with X, LinkedIn, Reddit, Copy link and Copy embed code, so they can pass it on;
  • See all possible outcomes, which opens the model in Machinations.

Un-share content

If at any point you want to make your public content private again, open the Share menu at the top right of the editor and choose Make private.