Lightweight Accordion


Lightweight Accordion plugin for WordPress allows you to add collapse elements to posts using a shortcode (via classic editor) or using a Gutenberg block. By using the details HTML tag and a few lines of CSS this allows for a javascript-free accordion for minimum page load.

Extremely Lightweight (<1kb): Without using Javascript the plugin uses the native details HTML tag and a few lines of code for almost no impact on front-end.

Customizable: Options include customizing the HTML tag used for the accordion title, open by default, orders, and colors.

Shortcode Usage examples

Here are a few examples of using the accordion plugin with shortcodes.

[lightweight-accordion title="My Accordion"]My Content[/lightweight-accordion]

Additionally you can display the accordion open on load with the accordion_open option.

[lightweight-accordion title="My Accordion" accordion_open=true]My Content[/lightweight-accordion]

You can also change the html tag wrapping the title of the accordion using the title_tag option.

[lightweight-accordion title="My Accordion" title_tag="h3"]My Content[/lightweight-accordion]

If you want to include FAQ schema you can add the schema option and set it to faq.

[lightweight-accordion title="What is your return policy?" schema="faq"]You have 1 week to return your items[/lightweight-accordion]

If you’d like put a border around the content of the accordion you can use the “bordered” attribute.

[lightweight-accordion title="Bordered Content" bordered=true]My Content[/lightweight-accordion]

Shortcode Options

Here is the full listing of shortcode options. Additionally all of these options are accessible when using the Gutenberg block.

  • title (Required Default: null) The title of your accordion will be displayed at the top for users to click. A good example would be to include a user’s question so they could click it for more details.
  • content (Required Default: null) Content that will go into your accordion element.
  • title_tag (Default: “span”) This sets the html tag that wraps the title in the accordion summary. Useful if you want to make it a heading tag for SEO purposes.
  • accordion_open (Default: false) Set this to true if you want your accordion to be open by default.
  • bordered (Default: false) Set this to true if you want a border around the accordion content.
  • title_text_color (Default: false) Set this to a hex value or CSS color to change the color of the accordion title text.
  • title_background (Default: false) Set this to a hex value or CSS color to change the color of the accordion title text.
  • schema (Default: false) Set this to faq if you’d like FAQ schema to be included.
  • class (Default: false) Used to add a custom class to the parent container of the accordion.
  • anchor (Default: null) Adds the value as an ID to the accordion div as an anchor.

Additional Details

If you’d like to remove the “lightweight-accordion.css” from being enqueued on your site use the filter below. It’s recommend you style the accordion yourself if you use this filter.

add_filter('lightweight_accordion_include_frontend_stylesheet', '__return_false' );

If you’d like to remove the “lightweight-accordion/editor-styles.css” from being enqueued in the admin area of your site you can use the filter below.

add_filter('lightweight_accordion_include_admin_stylesheet', '__return_false' );

If you’d like to remove processing of shortcodes in accordion content you can use this filter.

add_filter('lightweight_accordion_process_shortcodes', '__return_false' );

If you’d like to use inline Microdata for FAQ schema you can use this filter.

add_filter('lightweight_accordion_output_microdata', '__return_true' );


  • Example of the lightweight accordions on the front-end of the site.
  • Accordion options when using the Gutenberg block.


This plugin provides 1 block.

  • Lightweight Accordion Simple lightweight accordion collapsible block.


To install this plugin:

  1. Download the plugin
  2. Upload the plugin to the wp-content/plugins directory,
  3. Go to “plugins” in your WordPress admin, then click activate.
  4. Add the shortcode where you want the accordion to appear. Likewise in Gutenberg you can find the “Lightweight Accordion” block under the “widgets” section in the block selector.


November 29, 2021
This plugin adds like ZERO weight to default WP site. And it actually has a fair amount of options. Love it. Please author let us give you money for this. 🙂
April 14, 2021
It is by far the most lightweight block.
April 3, 2021
Protect your brain when you use this plugin. It will explode it if you're not careful.
March 25, 2021
I needed a quick and simple accordion with the option to either show or hide its content by default. And behold! The Lightweight Accordion does just that and does it perfectly. The simplicity of the accordion is incredible, I didn't have to do any over the top setup before usage, it just works. On the fly customization is also always appreciated, and this accordion has all of it's configuration options available right on the sidebar as you are editing. As the name mentions, it is very lightweight and the performance reflects that, I've had zero issues with any of the accordions I've added to my site! Oh and I can't forget, the developer response is fantastic! I contacted Andy with thoughts on a new feature and he got back to me right away saying it's in the works.
Read all 11 reviews

Contributors & Developers

“Lightweight Accordion” is open source software. The following people have contributed to this plugin.


“Lightweight Accordion” has been translated into 5 locales. Thank you to the translators for their contributions.

Translate “Lightweight Accordion” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Tested up to WordPress 5.8
  • Bug fix for __ declaration


  • Bug fix for copy and pasting the accordion title in Safari.


  • Anchor support in Gutenberg and shortcode which adds an ID to be used as an anchor (can be found in the advanced tab of Gutenberg or using the ‘anchor’ attribute in the shortcode).
  • Fixes bug when enabling microdata using the filter (removes JSON-LD output when using microdata).


  • FAQ schema for accordions now output as JSON-LD in the footer instead of as Microdata. If you’d like to continue using Microdata you can set the lightweight_accordion_output_microdata filter to true.


  • PHP Warning bug fix for “class” and “className”.


  • Empty array bug fix.
  • Included an example pane in the Gutenberg insert block page.


  • Readme update.
  • Added block.json to be included in Gutenberg block library.
  • Style bugfix in the Gutenberg editor.


  • New option to add a border around the accordion content on the front-end.
  • Shortcodes are now processed in the content of the accordion.
  • New filter to disable shortcode processing.


  • Tested up to WordPress 5.7.


  • New option for title and background color for the accordion tab (works with Gutenberg and shortcode).
  • New visual border to see what’s inside the accordion while using Gutenberg.
  • New ability to append a custom class to the main accordion div.
  • No longer runs content clean up processing (wpautop/preg_replace) to tab content when using Gutenberg.


  • CSS style compatibility fix for some themes.


  • Tested up to WordPress 5.6.
  • Bug fix in Gutenberg editor styles.


  • Added a slight opacity change animation when opening accordions.


  • Ability to add FAQ schema to a collapsible using the new ‘schema’ option in the shortcode or dropdown in the Gutenberg editor.
  • Bug fixes for PHP warnings.


  • Better Gutenberg editor styles to tell what is inside a collapsible.
  • Tested up to WordPress 5.5.


  • Bug fix: now runs wpautop() on the entire contents of the accordion (so the first paragraph won’t be missing a p tag now)


  • New filter to denqueue the lightweight accordion CSS from the front-end.

    add_filter(‘lightweight_accordion_include_frontend_stylesheet’, ‘__return_false’ );


  • Initial Release.