Camille Ricketts
Mar 14 '19 · 2 min read · 486 views
Toggles are a new type of tool for documents. You can use them to hide and reveal information as needed, keeping your pages simple and neat — even when they contain a ton of content!
  • Here's an example toggle. If you click on the little triangle, it'll open.
    You can add anything here (images, embeds, etc.), then hide it by clicking the triangle again.

Why use toggles?

  • Keep documents that might otherwise be long and complex short and easy to navigate.
  • Help your audience focus on one section of content at a time.
  • Give your reader the choice to drill into detail or stay at a high level.

Create a toggle

There are a few ways to create toggles on a page:
  • Click on the + in the left margin that appears when you hover over a new line. Choose Toggle List from the menu.
  • Type /toggle and then enter.
  • You can transform text, bullets or to-do items into toggles by pressing cmd/ctrl + / anywhere on the same line and typing toggle.
    • When you do this, any content nested under that block will be put inside the toggle. Like sub-bullets, for instance.
  • Toggles behave like bullets or checkboxes. When you press enter, another one appears on the next line.
  • Open the toggle by clicking on it or pressing tab on the next line. Anything you type will be nested inside that toggle.
You can nest any type of content block inside toggles:
  • More text
    Augusta Ada King, Countess of Lovelace (née Byron; 10 December 1815 – 27 November 1852) was an English mathematician and writer, chiefly known for her work on Charles Babbage's proposed mechanical general-purpose computer, the Analytical Engine. She was the first to recognize that the machine had applications beyond pure calculation, and published the first algorithm intended to be carried out by such a machine. As a result, she is sometimes regarded as the first to recognize the full potential of a "computing machine" and one of the first computer programmers.
  • In-line databases

Drag blocks into a toggle

Just like in-line pages, you can drag content blocks into toggles to nest them inside (even when a toggle is closed).


  • Can you create columns inside of a toggle?
    Officially, not yet. We're still working on building that in. Unofficially, here's a workaround you can use in the meantime 😉
  • Is there a way to expand or close all the toggles on a page at once?
    You can use cmd/ctrl + option + t to expand/close all toggles. Give it a try on this page!
    You can also select toggles and press enter to open them all at once.
  • Can you create headings that are toggles?
    Not at the moment, unfortunately. On our to-do list, though!

Related guides

Something we didn't cover? Message us in the app by clicking ? at the bottom right on desktop (or in your sidebar on mobile). Or email us at ✌️

Share on