Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/valentynabaranova/elementor-faq-accordion/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Custom Elementor widget — a numbered FAQ accordion with smooth expand/collapse animation and full styling via the Elementor panel.
Features
- Repeater for unlimited questions and answers
- WYSIWYG editor for answers (HTML, lists, links)
- "Open by default" option per item
- Automatic numbering (1., 2., 3. …)
- Smooth CSS expand animation (grid
0fr→1fr) - Full styling via Elementor Style tab: background, border radius, gaps, typography, icon, divider
- Accessibility:
aria-expanded,aria-controls,role="region",focus-visible - Responsive styles for mobile
Requirements
- WordPress 5.8+
- PHP 7.4+
- Elementor (free or Pro)
Installation
Option 1 — WordPress Admin
- Upload the
elementor-faq-accordionfolder towp-content/plugins/ - Go to Plugins → Installed Plugins and activate Elementor FAQ Accordion
- Make sure Elementor is also active
Option 2 — ZIP archive
zip -r elementor-faq-accordion.zip elementor-faq-accordion/
Upload the ZIP via Plugins → Add New → Upload Plugin.
Usage
- Open a page in the Elementor editor
- Find FAQ Accordion in the widget panel (category: General)
- On the Content tab, add questions and answers
- On the Style tab, customize colors, typography, and spacing
Project structure
elementor-faq-accordion/
├── elementor-faq-accordion.php
├── includes/
│ └── class-faq-accordion-widget.php
├── assets/
│ ├── css/
│ │ └── faq-accordion.css
│ └── js/
│ └── faq-accordion.js
├── .gitignore
└── README.md
Migration from child theme
If the widget was previously registered in your child theme's functions.php, remove these lines after activating the plugin to avoid double registration:
add_action( 'wp_enqueue_scripts', 'welleats_enqueue_faq_assets' );
add_action( 'elementor/widgets/register', 'welleats_register_faq_widget' );
The widget slug (welleats_faq_accordion) is unchanged — existing pages will continue to work.
Publish to GitHub
cd elementor-faq-accordion
git init
git add .
git commit -m "Initial release: Elementor FAQ Accordion widget v1.0.0"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/elementor-faq-accordion.git
git push -u origin main
License
MIT