{"id":322198,"date":"2026-06-06T23:30:17","date_gmt":"2026-06-06T23:30:17","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/block-collapser\/"},"modified":"2026-06-06T23:43:30","modified_gmt":"2026-06-06T23:43:30","slug":"collapsi-for-block-editor","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/collapsi-for-block-editor\/","author":23166909,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"Collapsi for the Block Editor","header_author":"Moaz Mahmoud","header_description":"Editor-only collapse\/expand toggle for every block in the WordPress editor. Hover a top-level block, click the chevron, and the block tucks into a compact bar with icon, title, and content preview. Survives reloads via localStorage. Works in Post Editor and Site Editor. No frontend impact.","assets_banners_color":"f8fcfb","last_updated":"2026-06-06 23:43:30","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/devMoaz\/collapsi-for-block-editor","header_author_uri":"https:\/\/www.linkedin.com\/in\/moazmahmmoud\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":60,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"devmoaz","date":"2026-06-06 23:43:30"}},"upgrade_notice":{"1.0.0":"

First public release of Collapsi for the Block Editor.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3563432,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3563432,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3563432,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3563432,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3563410,"resolution":"1","location":"assets","locale":"","width":1440,"height":900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3563410,"resolution":"2","location":"assets","locale":"","width":1440,"height":900},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3563410,"resolution":"3","location":"assets","locale":"","width":1440,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3563410,"resolution":"4","location":"assets","locale":"","width":1440,"height":900}},"screenshots":{"1":"The collapsed bar showing icon, block title, and content preview. Multiple blocks collapsed independently.","2":"Hovering a block reveals the chevron toggle in the top-left corner.","3":"The PluginSidebar with Collapse All, Expand All, and Focus Mode actions.","4":"The Settings page with three tabs: General, Behaviour, Appearance."}},"plugin_section":[],"plugin_tags":[148857,2124,148076,2345,3800],"plugin_category":[],"plugin_contributors":[266063],"plugin_business_model":[],"class_list":["post-322198","plugin","type-plugin","status-publish","hentry","plugin_tags-block-editor","plugin_tags-collapse","plugin_tags-gutenberg","plugin_tags-productivity","plugin_tags-ux","plugin_contributors-devmoaz","plugin_committers-devmoaz"],"banners":{"banner":"https:\/\/ps.w.org\/collapsi-for-block-editor\/assets\/banner-772x250.png?rev=3563432","banner_2x":"https:\/\/ps.w.org\/collapsi-for-block-editor\/assets\/banner-1544x500.png?rev=3563432","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/collapsi-for-block-editor\/assets\/icon-128x128.png?rev=3563432","icon_2x":"https:\/\/ps.w.org\/collapsi-for-block-editor\/assets\/icon-256x256.png?rev=3563432","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/collapsi-for-block-editor\/assets\/screenshot-1.png?rev=3563410","caption":"The collapsed bar showing icon, block title, and content preview. Multiple blocks collapsed independently."},{"src":"https:\/\/ps.w.org\/collapsi-for-block-editor\/assets\/screenshot-2.png?rev=3563410","caption":"Hovering a block reveals the chevron toggle in the top-left corner."},{"src":"https:\/\/ps.w.org\/collapsi-for-block-editor\/assets\/screenshot-3.png?rev=3563410","caption":"The PluginSidebar with Collapse All, Expand All, and Focus Mode actions."},{"src":"https:\/\/ps.w.org\/collapsi-for-block-editor\/assets\/screenshot-4.png?rev=3563410","caption":"The Settings page with three tabs: General, Behaviour, Appearance."}],"raw_content":"\n

Collapsi for the Block Editor<\/strong> adds an editor-only chevron toggle to every Gutenberg block. Hover any top-level block, click the chevron, and the block tucks away into a compact bar showing the block's icon, title, and a short content preview (paragraph text, image alt, \"5 blocks\", and so on). Toggle it back open with the same chevron.<\/p>\n\n

Built for the long pages and Site Editor templates where scrolling past 50 blocks to find the one you want is the daily annoyance. Collapsi is strictly editor-only<\/strong> \u2014 your published site is untouched, no extra CSS or JS ships to the frontend.<\/p>\n\n

Why this plugin<\/h4>\n\n
    \n
  • Stop scrolling endlessly.<\/strong> Collapse the sections you're not working on. Find the one you are in seconds.<\/li>\n
  • Works on every block.<\/strong> Core, third-party, custom, ACF \u2014 anything Gutenberg renders, Collapsi can collapse.<\/li>\n
  • Survives reloads.<\/strong> Collapse state is saved per post, per template, per browser. Come back tomorrow, your layout is where you left it.<\/li>\n
  • Per-instance opt-out.<\/strong> Set \"Never collapse this block\" on a hero or any pinned block from the block settings menu.<\/li>\n
  • Keyboard shortcut.<\/strong> Alt+Shift+C<\/code> toggles all top-level blocks at once. Discoverable in WP's shortcut help modal (?<\/code>).<\/li>\n
  • No telemetry. No remote calls. No premium upsell.<\/strong> Free, GPL, forever.<\/li>\n<\/ul>\n\n

    How it works<\/h4>\n\n

    The plugin hooks editor.BlockListBlock<\/code> with a higher-order component that wraps every top-level block. State lives in a @wordpress\/data<\/code> store and persists to localStorage<\/code> keyed by either the block's structural path (\"0.2.1\"<\/code>) or its user-set name from Gutenberg's rename feature. A PluginSidebar<\/code> exposes Collapse All \/ Expand All \/ Focus Mode. Settings live at Settings \u2192 Collapsi<\/code> and persist via the REST API.<\/p>\n\n

    Compatibility<\/h4>\n\n
      \n
    • WordPress 6.5+ (iframed editor)<\/li>\n
    • PHP 7.4+<\/li>\n
    • Post Editor and Site Editor<\/li>\n
    • Browsers: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+<\/li>\n<\/ul>\n\n

      Not in scope<\/h4>\n\n
        \n
      • No Classic Editor support \u2014 Gutenberg only<\/li>\n
      • No frontend collapse (this is an editor productivity plugin, not a UX framework)<\/li>\n
      • No premium tier<\/li>\n<\/ul>\n\n

        Development<\/h3>\n\n

        Source code, issue tracker, and build instructions live at https:\/\/github.com\/devMoaz\/collapsi-for-block-editor. The compiled assets in build\/<\/code> are produced by @wordpress\/scripts<\/code> (webpack) from the src\/<\/code> directory in the GitHub repository. Run npm install && npm run build<\/code> to reproduce.<\/p>\n\n\n

        Automatic<\/h4>\n\n
          \n
        1. Visit Plugins \u2192 Add New<\/code> in your wp-admin<\/li>\n
        2. Search for \"Collapsi for the Block Editor\"<\/li>\n
        3. Click Install Now<\/code> and then Activate<\/code><\/li>\n<\/ol>\n\n

          Manual<\/h4>\n\n
            \n
          1. Download the plugin .zip<\/li>\n
          2. Visit Plugins \u2192 Add New \u2192 Upload Plugin<\/code><\/li>\n
          3. Choose the .zip and click Install Now<\/code>, then Activate<\/code><\/li>\n<\/ol>\n\n

            After activation, open any post in the editor and hover any top-level block \u2014 the chevron appears top-left.<\/p>\n\n\n

            \n

            Does this affect my published site?<\/h3><\/dt>\n

            No. Collapsi injects nothing into the frontend. The CSS is enqueued via enqueue_block_assets<\/code> with an is_admin()<\/code> guard, and the JS is enqueued via enqueue_block_editor_assets<\/code> which only fires inside the editor. Verified on every release.<\/p><\/dd>\n

            Where is the collapsed state stored?<\/h3><\/dt>\n

            In your browser's localStorage, keyed by collapsi:v1:post:<postId><\/code>. It's per-browser and per-device \u2014 switching to a different machine or browser starts fresh. Collapsi makes no server-side or remote calls to persist state.<\/p><\/dd>\n

            I renamed a block via Gutenberg's \"Rename\" feature. Does the collapsed state survive reorder?<\/h3><\/dt>\n

            Yes. When you set a metadata.name<\/code> via the block rename feature, the persistence key becomes name:<your-name><\/code>. Reorder the block, the key still matches, the collapsed state survives.<\/p><\/dd>\n

            Can I exclude specific blocks from collapsing?<\/h3><\/dt>\n

            Yes. Open any top-level block's three-dot \u22ee menu and click \"Never collapse this block\". The setting persists with the post.<\/p><\/dd>\n

            Does it work in the Site Editor?<\/h3><\/dt>\n

            Yes. Templates and template parts are treated the same as posts.<\/p><\/dd>\n

            How do I customize the accent color?<\/h3><\/dt>\n

            Settings \u2192 Collapsi \u2192 Appearance \u2014 change the accent color and bar title color, then save.<\/p><\/dd>\n

            Will it slow down the editor with 100 blocks on a page?<\/h3><\/dt>\n

            No. Selector subscriptions are per-clientId<\/code>, so a toggle on one block has no rendering impact on the other 99. Profiled on a 100-block stress page: a single toggle re-renders 1 wrapper.<\/p><\/dd>\n

            Does it support RTL languages?<\/h3><\/dt>\n

            Yes. The plugin enqueues editor-rtl.css<\/code> automatically via wp_style_add_data<\/code>.<\/p><\/dd>\n

            How do I theme the collapsed bar?<\/h3><\/dt>\n

            Both the accent (left border + icon) and the bar title color are user-configurable under Settings \u2192 Collapsi \u2192 Appearance<\/code>. The preview text harmonizes with the title color automatically.<\/p><\/dd>\n

            What's the keyboard shortcut?<\/h3><\/dt>\n

            Alt+Shift+C (Windows\/Linux) or Ctrl+Alt+C<\/code> (macOS). Toggles all top-level blocks. Discoverable in WP's shortcut help modal (?<\/code> key inside the editor).<\/p><\/dd>\n

            How do I uninstall cleanly?<\/h3><\/dt>\n

            Just delete the plugin from Plugins \u2192 Installed Plugins<\/code> \u2014 the plugin's option is removed automatically (single-site and multisite). The per-post collapse state lives in your browser's localStorage and stays there until you clear browser storage; it doesn't affect anything else.<\/p><\/dd>\n\n<\/dl>\n\n\n

            1.0.0<\/h4>\n\n
              \n
            • Initial public release.<\/li>\n
            • HOC wraps top-level Gutenberg blocks with a chevron toggle.<\/li>\n
            • Per-block-type content preview (paragraph, heading, image, list, group, columns, cover, buttons, quote, code, video, audio).<\/li>\n
            • Collapse state persists to localStorage<\/code>, keyed by structural path or metadata.name<\/code>. Survives reorder when renamed.<\/li>\n
            • PluginSidebar with Collapse All \/ Expand All \/ Focus Mode.<\/li>\n
            • Keyboard shortcut Alt+Shift+C<\/code> toggles all top-level blocks.<\/li>\n
            • Per-instance \"Never collapse this block\" via the block settings menu.<\/li>\n
            • Settings page at Settings \u2192 Collapsi<\/code> (3 tabs: General, Behaviour, Appearance) \u2014 backed by REST.<\/li>\n
            • Auto-collapse on editor load: off, or all top-level blocks.<\/li>\n
            • Screen-reader announcements via wp.a11y.speak()<\/code>.<\/li>\n
            • RTL stylesheet and prefers-reduced-motion<\/code> honored.<\/li>\n
            • Multisite-aware uninstall.<\/li>\n
            • Works in Post Editor and Site Editor.<\/li>\n<\/ul>","raw_excerpt":"Editor-only collapse\/expand toggle for every Gutenberg block. Tame long posts and templates without losing your place.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/322198","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=322198"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/devmoaz"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=322198"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=322198"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=322198"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=322198"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=322198"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=322198"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}