Title: Block Minimap
Author: Adam Silverstein
Published: <strong>October 21, 2019</strong>
Last modified: October 5, 2026

---

Search plugins

![](https://ps.w.org/block-minimap/assets/banner-772x250.png?rev=3725579)

![](https://ps.w.org/block-minimap/assets/icon.svg?rev=3725579)

# Block Minimap

 By [Adam Silverstein](https://profiles.wordpress.org/adamsilverstein/)

[Download](https://downloads.wordpress.org/plugin/block-minimap.1.2.0.zip)

 * [Details](https://en-ca.wordpress.org/plugins/block-minimap/#description)
 * [Reviews](https://en-ca.wordpress.org/plugins/block-minimap/#reviews)
 *  [Installation](https://en-ca.wordpress.org/plugins/block-minimap/#installation)
 * [Development](https://en-ca.wordpress.org/plugins/block-minimap/#developers)

 [Support](https://wordpress.org/support/plugin/block-minimap/)

## Description

Long posts get hard to navigate in the block editor. Block Minimap adds a sidebar
that draws the whole post in miniature, so you can see its structure at a glance
and move around it quickly.

 * **Every block gets a shape.** Headings, paragraphs, lists, quotes, tables, code,
   images, galleries, media and text, buttons, social links, embeds and more each
   render as a small sketch of what they look like in the post. Third party blocks
   without their own shape fall back to their block icon and title.
 * **Nested blocks show the document tree.** Groups, covers and other container 
   blocks draw their inner blocks inside them, and Columns sit side by side the 
   way they do in the post.
 * **Scroll sync.** The minimap and the editor canvas stay scrolled to the same 
   content. Scroll the post and the minimap follows; scroll the minimap and the 
   post follows.
 * **Compact sizes.** Below 100%, body text draws as gray bars the length of each
   line while headings stay readable, so a long post fits in fewer sidebar screens.
   Automatic picks a size from the length of the post.
 * **Viewport spotlight.** A frame marks the part of the minimap visible in the 
   editor and dims the rest. Drag the frame to scroll the post.
 * **Safe previews.** Custom HTML, shortcode and classic blocks render as escaped
   source rather than live markup.

Open the minimap from the Block Minimap item in the editor’s Options menu.

[Try Block Minimap in WordPress Playground](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/adamsilverstein/block-minimap/master/.wordpress-org/blueprints/blueprint.json)–
it opens a long demo post in the editor with the minimap already showing, no install
needed.

Development takes place in the [GitHub repository](https://github.com/adamsilverstein/block-minimap).
Issues and pull requests are welcome.

## Screenshots

[⌊Scrolling a long post with the minimap following along, then dragging the spotlight
frame to move through the post.⌉⌊Scrolling a long post with the minimap following
along, then dragging the spotlight frame to move through the post.⌉[

Scrolling a long post with the minimap following along, then dragging the spotlight
frame to move through the post.

[⌊The Block Minimap sidebar next to a long post, scrolled in step with the editor
canvas.⌉⌊The Block Minimap sidebar next to a long post, scrolled in step with the
editor canvas.⌉[

The Block Minimap sidebar next to a long post, scrolled in step with the editor 
canvas.

[⌊Nested blocks and Columns rendered side by side in the minimap.⌉⌊Nested blocks
and Columns rendered side by side in the minimap.⌉[

Nested blocks and Columns rendered side by side in the minimap.

[⌊Different block types - images, quotes, tables, code, galleries - each drawn in
its own shape.⌉⌊Different block types - images, quotes, tables, code, galleries -
each drawn in its own shape.⌉[

Different block types – images, quotes, tables, code, galleries – each drawn in 
its own shape.

## Installation

 1. Install the plugin via the plugin installer, either by searching for it or uploading
    a .zip file.
 2. Activate the plugin.
 3. Use Block Minimap!

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Block Minimap” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ Adam Silverstein ](https://profiles.wordpress.org/adamsilverstein/)

[Translate “Block Minimap” into your language.](https://translate.wordpress.org/projects/wp-plugins/block-minimap)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/block-minimap/), check
out the [SVN repository](https://plugins.svn.wordpress.org/block-minimap/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/block-minimap/) 
by [RSS](https://plugins.trac.wordpress.org/log/block-minimap/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.2.0

 * A size control for the minimap: Automatic, 100%, 2/3 and 1/2. Below 100%, body
   text draws as gray bars while headings stay readable.
 * A spotlight marks the part of the minimap visible in the editor and dims the 
   rest, drawing it as a miniature of the editor. Drag it to scroll the post, or
   turn it off with Highlight visible area.

#### 1.1.0

 * Minimap representations for all block types, including third party blocks.
 * Nested blocks render as the document tree, with Columns side by side.
 * The minimap and the editor canvas scroll together: scrolling either one scrolls
   the other to the same content.
 * Quotes, tables, code, galleries, media, buttons, social links, embeds and document
   chrome each render in their own shape.
 * Custom HTML, shortcode and classic blocks render as escaped source rather than
   live markup.

#### 1.0.1

 * Confirm compatibility with WordPress 7.1.
 * Declare the editor script dependencies (lodash, wp-components, wp-data, wp-edit-
   post, wp-element, wp-i18n, wp-plugins). Without them the minimap failed to load
   with “lodash is not defined”.

#### 1.0.0

Added
 * Initial plugin release 🎉

## Meta

 *  Version **1.2.0**
 *  Last updated: **1 week ago**
 *  Active installations: **Fewer than 10**
 *  WordPress Version: ** 5.4 or higher **
 *  Tested up to: **7.1.3**
 *  PHP Version: ** 5.6 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/block-minimap/)
 * Tags:
 * [block-editor](https://en-ca.wordpress.org/plugins/tags/block-editor/)[gutenberg](https://en-ca.wordpress.org/plugins/tags/gutenberg/)
   [navigation](https://en-ca.wordpress.org/plugins/tags/navigation/)[outline](https://en-ca.wordpress.org/plugins/tags/outline/)
 *  [Advanced View](https://en-ca.wordpress.org/plugins/block-minimap/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/block-minimap/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/block-minimap/reviews/)

## Contributors

 *   [ Adam Silverstein ](https://profiles.wordpress.org/adamsilverstein/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/block-minimap/)