The Tabs block helps you put several pieces of content side by side. Your reader picks which one to look at.
What should I use a tab for? π€
Mac and Windows instructions, one section per plan, a snippet in three languages: anything where most readers only need one of the options and shouldn't have to scroll past the others to find it.
Adding a Tabs Block
Type / anywhere in an article and pick Tabs.
/tabs, /tabbed, and /panels all find it. Each tab is two pieces that stay paired:
Part | What It's For |
Label | The button in the bar along the top. Keep it to a word or two. It has to fit alongside the others |
Panel | The content shown when that label is picked. A panel takes any blocks you like, including images, code, and callouts. Just hit |
Already written the first version as a paragraph? Open that block's menu and pick Turn into > Tabs. Its text moves into the first tab, with a second empty tab beside it.
Building a Tabs Block
A new Tabs block comes with two empty tabs ready to go, and your cursor starts in the first label.
- Type the first tab's name
- Click into the panel below and add your content
- Click the second label and do the same
- Need more? Click + Add tab at the end of the bar, and repeat until every option has its own tab
Hover a label to reveal its controls:
Control | What It Does |
Drag handle | Reorders the tab. The panel moves with its label, so content never ends up under the wrong heading |
Delete tab | Removes the label and its panel together. A block always keeps at least one tab, so the last one can't be deleted |
Keyboard Shortcuts
Tabs have their own navigation, so you can build one without reaching for the mouse:
Keys | What It Does |
| Moves from a label into its panel, then on to the next tab. At either end you step out of the block |
| Drops into that tab's panel |
| Adds a new tab before or after the one you're in, and puts your cursor in its label |
| At the start or end of the text, hops to the neighbouring label |
| Selects just the label or panel you're in, not the whole article |
Limits
A block holds up to 10 tabs. In practice the bar gets crowded well before that, especially on a phone, so treat anything past five or six as a prompt to check whether the tabs are really parallel options or a list in disguise.
What Readers Get
Tabs are built with plain CSS and no JavaScript, so they work on every theme and never wait on a script to become clickable. Here's one in action. Click the labels to switch:
To take a screenshot of part of your screen:
- Press
Cmd+Shift+4 - Drag across the area you want to capture
- Find the image on your desktop
To take a screenshot of part of your screen:
- Press
Windows+Shift+S - Drag across the area you want to capture
- Paste it wherever you need it, or click the notification to save it
For the rest of the toolbox see Understanding Block Types, or Shortcuts in the Block Editor for the full keyboard reference.