FAQ & Troubleshooting
Answers to frequently asked questions and solutions to common issues.
General Questions
What is Magical Shop Builder?
Magical Shop Builder (formerly Magical Products Display) is a comprehensive WooCommerce page builder plugin for Elementor. It provides 68+ widgets and a template system to customize every WooCommerce page — product pages, shop archives, cart, checkout, my account, and thank you pages.
What are the requirements?
WordPress 6.0+, PHP 7.4+, WooCommerce 8.0+, and Elementor 3.15+ (free version). Elementor Pro is NOT required.
Is Elementor Pro required?
No! Magical Shop Builder works with the free version of Elementor. It provides its own template system that replaces the need for Elementor Pro's Theme Builder for WooCommerce pages. However, if you have Elementor Pro, the plugin integrates with its Theme Builder seamlessly.
Does it work with my theme?
Yes, Magical Shop Builder is theme-agnostic and works with any properly coded WordPress theme. It's tested with popular themes like Astra, Hello Elementor, GeneratePress, OceanWP, Kadence, and Blocksy.
How many widgets are included?
The free version includes 63+ widgets across 8 categories. The Pro add-on adds 5 more exclusive widgets for a total of 68+.
Does the plugin support RTL languages?
Yes, it fully supports RTL layouts. The plugin includes translations for Arabic (RTL) and 9 other languages.
Installation & Setup
The plugin won't activate. What should I do?
Make sure WooCommerce and Elementor (free) are both installed and activated before activating Magical Shop Builder. Check that your PHP version is 7.4 or higher.
I see a "missing dependencies" error.
The plugin requires both WooCommerce and Elementor. Install and activate both plugins first.
How do I install the Pro add-on?
Purchase a Pro license, download the Pro add-on ZIP file, upload via Plugins → Add New → Upload Plugin, activate it, then enter your license key in Magical Shop Builder → Settings → License.
Where do I find the plugin settings?
After activation, go to Magical Shop Builder in the WordPress admin menu. The plugin has a React-powered dashboard at Magical Shop Builder → Dashboard for managing templates, widgets, and settings.
Templates & Conditions
My template is not showing on the frontend.
Check these things:
- The template has conditions assigned
- The template is published (not draft)
- The conditions match the page you're viewing
- No higher-priority template is overriding it
- Clear any caching plugins
Can I have different templates for different product categories?
Yes! Use the "Product Category" condition type when setting up template conditions. You can assign different single-product templates to different categories.
How does template priority work?
Lower numbers = higher priority. If multiple templates match the same page, the one with the lowest priority number wins. "Specific Product" conditions override category conditions.
What template types are available?
7 types: Single Product, Archive/Shop, Cart, Checkout, My Account, Empty Cart, and Thank You page.
Can I import pre-built layouts?
Yes! The Template Builder includes a pre-layout library with professionally designed templates. Click the "Pre Layouts" tab in the template editor to browse and import layouts.
Widgets
My widgets don't appear in the Elementor editor.
Look for the "Magical Shop" category in the Elementor widget panel. If widgets are missing, check Dashboard → Widgets to ensure they're enabled. Some widgets only appear when editing specific template types.
Can I disable widgets I don't use?
Yes! Go to Magical Shop Builder → Dashboard → Widgets. You can enable/disable individual widgets. Disabling unused widgets improves performance.
Why is a widget showing a "Pro" badge?
Widgets with Pro badges require the Magical Shop Builder Pro add-on. The free plugin shows a lock overlay on Pro-only features. Purchase Pro to unlock these widgets.
AJAX filtering isn't working on my shop page.
Ensure you're using the MPD Shop Archive template (not a default WooCommerce template). Check that JavaScript is not blocked by any optimization plugin. Test with a default theme to rule out conflicts.
Performance
How do I enable CSS/JS minification?
Go to Magical Shop Builder → Settings → Performance. Enable "Minify CSS" and "Minify JS". Minified files are cached in wp-content/uploads/mpd-cache/.
My site is slow after installing the plugin.
- Enable performance features in Settings → Performance
- Disable unused widgets in Dashboard → Widgets
- Enable template caching
- Defer JavaScript loading
- Make sure you're not loading both Block and Classic checkout
How do I clear the template cache?
Template cache is stored as WordPress transients. Use a transient cleaner plugin, or the cache auto-expires. You can also clear it by saving any template.
Compatibility
Does it work with WooCommerce HPOS?
Yes, Magical Shop Builder is compatible with WooCommerce High-Performance Order Storage (HPOS).
Does it work with WooCommerce Block Cart/Checkout?
The plugin detects WooCommerce Block Cart/Checkout and handles compatibility. For best results with custom cart/checkout templates, use the Classic (shortcode-based) cart and checkout.
Is it compatible with caching plugins?
Yes, it works with popular caching plugins like WP Rocket, W3 Total Cache, LiteSpeed Cache, and WP Super Cache. After making template changes, clear your cache.
Does it work with multilingual plugins (WPML, Polylang)?
The plugin is translation-ready with 10 language files included. It works with WPML and Polylang for multilingual sites.
Troubleshooting Guide
Solution: Check PHP version (7.4+ required), increase PHP memory limit to 256MB, check error logs in wp-content/debug.log.
Solution: Clear browser cache and any caching plugin cache. Check if CSS minification is enabled in performance settings. Verify no CSS conflicts with your theme.
Solution: Make sure conditions are properly set and the template is published. Check template priority. If using Elementor Pro Theme Builder, MPD templates may conflict — use one system or the other for each page type.
Solution: Check browser console for JavaScript errors. Verify AJAX URL is correct. Test with default theme. Disable other plugins that modify WooCommerce queries.
Solution: The admin dashboard requires JavaScript. Check for JS errors in browser console. Try disabling browser extensions. Clear browser cache.
Solution: The pre-layout server (mp.wpcolors.net) must be accessible. Check if your server can make outbound HTTP requests. Layouts are cached for 1 day — wait and retry.
Getting Help
If you can't find the answer to your question above, here are additional support channels:
- WordPress.org Support Forum — Post your question in the plugin's official support forum on WordPress.org for community and developer assistance.
- Plugin Documentation — You're already here! Browse the sidebar to explore all documentation pages.
- Pro Users: Priority Email Support — Pro license holders receive priority email support with faster response times.
- GitHub Issues — Report bugs or request features via the plugin's GitHub repository.
Please include: WordPress version, PHP version, WooCommerce version, Elementor version, active theme name, and steps to reproduce the problem.