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 Listfrom the menu.
- You can transform text, bullets or to-do items into toggles by pressing
/anywhere on the same line and typing
- 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
tabon the next line. Anything you type will be nested inside that toggle.
You can nest any type of content block inside toggles:
More textAugusta 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.
Images, videos, and other embeds
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
tto expand/close all toggles. Give it a try on this page!You can also select toggles and press
enterto open them all at once.
Can you create headings that are toggles?Not at the moment, unfortunately. On our to-do list, though!
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 email@example.com ✌️