Pin blocks and patterns

A pinned tool inserts one block type or one pattern. You can pin any block type that you can insert, and any pattern.

Pin a block type or a pattern

Use one of these methods:

  • Open Toolbar settings. In the Add a block or pattern field, type part of the name. Click the result. The list shows up to 12 block types and up to 12 patterns. It does not show items that are already pinned.
  • Drag a block or a pattern from the block inserter and drop it on the toolbar.
  • Select one block in the canvas. Open the block’s options menu and choose Pin to toolbar. This pins the block type.

The search finds your own patterns, the patterns of your theme and the core patterns.

Pin a block with its settings and contents

A pinned block type inserts an empty block. To pin a block as you set it up, save it as a pattern:

  1. Select the block, or select more than one block.
  2. Open the block’s options menu and choose Save as pattern and pin to toolbar…. You can also drag a block from the canvas and drop it on the toolbar.
  3. In the Add to toolbar dialog, type a name in Pattern name.
  4. Click Save pattern and pin it.

EditRail saves the blocks as one of your patterns. The pattern is not synced. If you edit a copy that you inserted, the pattern does not change.

The same dialog also has a button to pin the block type alone, with no settings. If your account cannot create patterns, the dialog tells you so.

How a pinned pattern inserts

An armed pattern inserts a new copy of its blocks. A synced pattern inserts a reference to the pattern, the same as the block inserter does.

Reorder and unpin

Open Toolbar settings. Each item under Pinned tools has these buttons:

  • Move up and move down: change the order on the toolbar.
  • Edit: give the tool your own name, description or icon.
  • Unpin: remove the tool from the toolbar.

You can also choose Unpin from toolbar in the options menu of a block of that type.

If you unpin a default tool, click Restore default tools. It adds the missing default tools to the end of the toolbar. Your other pins do not change.

Give a tool your own name, description and icon

  1. Open Toolbar settings.
  2. Under Pinned tools, click Edit beside the tool.
  3. Fill in the fields that you want to change. Leave a field empty to use the block’s own value.
  4. Click Save.
  • Name: up to 80 characters.
  • Description: up to 240 characters. It shows in the tool’s tooltip, after the name.
  • Icon: up to 3 characters, such as “Aa” or a symbol, or the name of a Dashicon. Click Browse icons to search the Dashicons.

Click Reset to go back to the block’s own name, description and icon. A tool with your own values has a Custom tag in the list.

These values change your toolbar only. Saved sets keep them, and set files carry them.

Where pins are saved

Pins are saved to your user account on this site. They follow you to other browsers and devices. To use your pins on a different site, export them as a set. See Saved sets.