> ## Documentation Index
> Fetch the complete documentation index at: https://help.standards.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Toggle

Toggles are interactive content elements comprised of two slides that toggle back and forth between one another.

<Frame>
  <img src="https://mintcdn.com/standards/pm-vYHBcp5dA9tzY/images/toggle-01_1.gif?s=077a38f31756461b608b26cb078dfa72" alt="Toggling between alternate G in character style example" width="1200" height="600" data-path="images/toggle-01_1.gif" />
</Frame>

***

## Basics

* Toggles always consist of two slides. Slides are are the containers, similar to columns, that content such as media or video are added to.
* Toggles always include controls. Controls are the buttons that control switching between the slides. These can be styled like buttons, and made into components for ease of applying a consistent settings.
* Slides can contain multiple elements, such as video, media, text, etc.

### Add a toggle

<Frame>
  <img src="https://mintcdn.com/standards/rVQ0ufZ3xBiSqe1k/images/toggle-add-menu.png?fit=max&auto=format&n=rVQ0ufZ3xBiSqe1k&q=85&s=94d867e9862bb2c4f63373d363052ec5" alt="Add menu dropdown open showing a list of all options" width="1200" height="600" data-path="images/toggle-add-menu.png" />
</Frame>

<Steps>
  <Step title="Select the toggle add tool">
    From within the editor, select **Toggle** from the `+`menu in the top bar
  </Step>

  <Step title="Select area to add to">
    Select a point in the project body by selecting between layouts, click + dragging within, or selecting a point inside a column
  </Step>

  <Step title="Add content">
    Select the placeholder media within each slide, then choose add media from the fill settings group in the right sidebar, then select a file.
  </Step>

  <Step title="Optional: Add more content to slides">
    Slides are containers similar to columns, that content such as media or video are added to. Add into slides by selecting any element from the `+` menu, and clicking inside the slide.
  </Step>
</Steps>

***

## Examples

Toggles are great for showing variations of something such as stylistic alternates, or to expose a second level of guidance, like a clear space diagram.

<Frame>
  <img src="https://mintcdn.com/standards/pm-vYHBcp5dA9tzY/images/toggle-02_1.gif?s=88de118258dff31d9957da8c1febc3ea" alt="Toggle 02 1" width="1200" height="600" data-path="images/toggle-02_1.gif" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/standards/pm-vYHBcp5dA9tzY/images/toggle-03.gif?s=ef5acce7b973cd268a3104c98f0bba6d" alt="Toggle 03" width="1200" height="600" data-path="images/toggle-03.gif" />
</Frame>

***

## Transition

Inherent to **Toggles** are the transition between the two slides. Transition motion, behavior, and duration can be controlled.

<Frame>
  <img src="https://mintcdn.com/standards/pm-vYHBcp5dA9tzY/images/toggle-04.png?fit=max&auto=format&n=pm-vYHBcp5dA9tzY&q=85&s=4def8fda6bffcad9473824985c69965c" alt="Contextual toolbar beside toggle with behavior settings" width="2400" height="1200" data-path="images/toggle-04.png" />
</Frame>

### Change transition

<Steps>
  <Step title="Select toggle">
    From in body or the left sidebar, select the toggle element
  </Step>

  <Step title="Select transition button">
    From the contextual toolbar, select the transition button to show the transition settings
  </Step>

  <Step title="Choose transition settings">
    Modify the transition settings to your preference
  </Step>
</Steps>
