❓ Frequently Asked Questions

Everything you need to know about ACO Product Grid

🏠 General

What is AcoDesign Product Grid?

AcoDesign Product Grid is a premium WooCommerce plugin that replaces the default product loop design on your shop, category, and archive pages with modern, feature-rich product cards. It includes hover effects, badges, videos, floating action buttons, a built-in wishlist, a compare system, and AJAX modals — all without touching your theme code.

Do I need WooCommerce?

Yes. AcoDesign Product Grid requires WooCommerce 6.0 or higher. The plugin will not function without WooCommerce installed and activated.

Does it work with any theme?

The plugin includes a multi-layer theme compatibility system tested with Kadence, Blocksy, Astra, Storefront, and most WooCommerce-compatible themes. If you experience layout issues, try switching to a default theme to isolate the problem. Contact support if your theme is incompatible.

Will this plugin slow down my site?

No. The plugin loads its CSS and JS only when WooCommerce is active and a valid license is present. It uses Swiper.js from a CDN (jsDelivr), only enqueues assets on WooCommerce pages, and caches settings to minimize database queries. Inline CSS is generated once per page load.

Is the plugin translation-ready?

Yes. The plugin includes a .pottemplate file and a complete Spanish translation. You can create additional translations using Poedit or Loco Translate with the text domain acodesign-product-loop-styles.

🔑 License

Why do I need a license?

AcoDesign Product Grid is a premium plugin. The license key activates automatic updates, support access, and enables the plugin’s frontend assets. Without an active license, the default WooCommerce product loop is shown instead of the ACO design.

How do I activate my license?

Go to **Product Grid → License**, paste your license key, and click **Activate License**. The key is validated against the ACO Design server at `https://acodesign.dev`.

My license says "Active" but the styles aren't showing. Why?

Possible causes:

WooCommerce is not installed or activated.
A caching plugin is serving stale pages — clear your cache.
Your theme is forcefully overriding WooCommerce templates — try Storefront temporarily.
Revalidate your license under **Product Grid → License**.

Can I use the same license on multiple sites?

It depends on your license tier:

– **Starter (L1):** 1 domain

– **Pro (L2):** 3 domains

– **Agency (L3):** 25 domains

Deactivate the license on one site before activating it on another to free a slot.

What happens if the license server is down?

The plugin includes a grace period. Your site will continue working normally even if the license server is temporarily unreachable.

How do I transfer my license to a new domain?

Deactivate the license on the old site first (**Product Grid → License → Deactivate**), then activate it on the new site.

🎨 Styles & Design

How many styles are available?

Four pre-designed styles:

– **Style 1 (Mardox V9):** Classic, clean layout with hover-reveal icons.

– **Style 2 (Hover Swatches):** Variation swatches appear on image hover.

– **Style 3 (Interactive Quantity Bar):** Quantity selector integrated into the card.

– **Style 4 (Tooltips Above Icons):** Floating icons with tooltip labels.

Can I customize the colors?

Yes. The **Product Card** and **Main Button** tabs let you customize virtually every color: badges, titles, prices, buttons, icons, backgrounds, borders, and more. All changes are applied via CSS custom properties and take effect immediately.

Can I use my own custom icons instead of the default SVGs?

Yes. Once you enable **Enable SVG Uploads** in the General Tab, you can go to the **Custom Icons Tab** to upload your own custom SVGs for the Quick View, Wishlist, Compare, Add to Cart, and Carousel Navigation arrows.

Can I use different styles on different pages?

Yes. Both the [acodesign_products] and [acodesign_carousel] shortcodes accept a style parameter (e.g., style="style_2"). Gutenberg blocks and Elementor widgets also have a style selector. The global active style is only used when no per-instance style is specified.

How do I change the "Add to Cart" button text?

Go to **Product Grid → Main Button** and customize:

– **Add to Cart Text** (simple products)

– **Select Options Text** (variable products)

– **Quick Add Button Text** (Quick Add modal trigger)

Can I hide the star ratings in the product loop?

Yes. Toggle **Product Card → Enable Ratings** off.

Can I change how many columns show on mobile?

Yes. Set **Product Card → Mobile Columns** to `1` or `2`. This applies to all product loops and carousels on screens ≤ 768px wide.

🧩 Shortcodes & Blocks

What shortcodes are available?

[acodesign_products] — Product grid with optional Load More or native pagination
[acodesign_carousel] — Product carousel (Swiper-based)
[acodesign_wishlist] — Wishlist page content
[acodesign_wishlist_counter] — Wishlist icon with item count
[acodesign_wishlist_button] — Add-to-wishlist toggle button
[acodesign_product_countdown] — Sale countdown timer

Full parameter documentation is in the Shortcodes section of the documentation.

Does the native shortcode work?

Yes. Add style="style_1" (or style_2, style_3, style_4) to any native WooCommerce

shortcode, and ACO styles will be applied automatically. Example:

[products limit="8" columns="4" style="style_1"]

Can I use these with page builders?

Yes. ACO Product Grid includes:

– **Gutenberg blocks:** ACO Product Grid, ACO Product Carousel, and ACO Product Archive

– **Elementor widgets:** Product Grid, Product Carousel, and Product Archive (under the WooCommerce Elements category)

How do I create a "Load More" grid?

Use the [acodesign_products] shortcode with load_more="true" :

[acodesign_products columns="4" limit="8" total_limit="24" load_more="true" category="clothing"]

The limit controls how many products appear per page, and total_limit controls the maximum total. Set total_limit="-1" for unlimited.

Does the grid support native numbered pagination?

Yes. Use paginate="true" in the [acodesign_products] shortcode instead of load_more. This will display native theme numbered pagination below the grid.

Can I filter the Carousel by sale, best selling, or attributes?

Yes. The [acodesign_carousel] shortcode accepts the same advanced filters as the Grid:

on_sale="true" — Show only sale products
best_selling="true" — Sort by best selling
top_rated="true" — Sort by top rated
attribute="pa_color" — Filter by product attribute
terms="red,blue" — Attribute term slugs

What is the Product Archive block/widget?

The ACO Product Archive block and widget automatically inherit the current WooCommerce query (shop page, category, or tag archive) and apply ACO styling without needing to configure product filters. It is ideal for shop and category archive templates when using Gutenberg or Elementor.

🎬 Video

How do I add a video to a product card?

Edit a product in WooCommerce.
Find the **Product Video** meta box.
Upload an MP4 video (via BunnyCDN if configured, or paste a direct MP4 URL).
Save the product.

What video formats are supported?

MP4 and WebM. The plugin verifies MIME types via `finfo` and enforces a 5 MB maximum file size for BunnyCDN uploads.

Can I use YouTube or Vimeo videos?

No. Only direct MP4/WebM video URLs are supported. YouTube and Vimeo embeds will not work in the product loop.

How do I set up BunnyCDN for videos?

Create a BunnyCDN storage zone and pull zone.
Go to **Product Grid → BunnyCDN Integration**.
Enable the uploader and enter your storage zone name, password, and pull zone URL.
The video uploader will now appear on each product edit screen, uploading directly to BunnyCDN.

❤️ Wishlist & Compare

Do I need YITH Wishlist or YITH Compare?

No. AcoDesign Product Grid includes fully native wishlist and compare systems. The built-in systems work for both guest and logged-in users, with cookie-based and user-meta-based storage.

If you already use YITH plugins, AcoDesign Product Grid is compatible — it reuses YITH’s buttons inside its own floating icon wrapper and prevents duplicate buttons.

Where is the wishlist page?

The plugin automatically creates a Wishlist page (slug: `wishlist`) on activation. If it’s missing, go to **Product Grid → Wishlist** and click **Generate Wishlist Page**.

How do I show the wishlist counter in my header?

Add the `[aco_wishlist_counter]` shortcode to a header widget area, a navigation menu item, or via a theme hook. Contact your theme developer for the correct hook or widget area.

How many products can I compare?

Up to 4 products simultaneously. Adding a fifth product replaces the oldest one.

Where does the compare bar appear?

By default, at the bottom-right of the screen. You can change position and offset under **Product Grid → Floating Icons → Compare Bar Position / Side Offset / Bottom Offset**.

🔌 Compatibility

Does it work with Variation Swatches for WooCommerce?

Yes. AcoDesign Product Grid is designed to integrate with **Variation Swatches for WooCommerce** (free plugin by CartFlows). The plugin:

– Automatically repositions swatches for proper layout.

– Enables swatches on related products and modals.

– Offers the swatches limiter feature (show only N swatches per card).

– Provides one-click installation from admin notices.

My theme's product layout looks broken after activation. What should I do?

Clear all caches (plugin, server, CDN).
Go to **Product Grid → General** and ensure an active style is selected.
Temporarily switch to a default theme (Storefront or Twenty Twenty-Four). If it works, your theme needs compatibility adjustments.
Contact support with your theme name and version.

Does it work with WPML?

Yes. The plugin is WPML compatible. All strings use the text domain `acodesign-product-loop-styles` and can be translated. Spanish translation is included.

Does it work with High-Performance Order Storage (HPOS/COTS)?

Yes. The plugin declares compatibility with WooCommerce’s custom order tables via `before_woocommerce_init`.

🔧 Troubleshooting

The plugin's styles aren't loading on the frontend.

Verify your license is active (**Product Grid → License**).
Confirm WooCommerce is installed and active.
Clear your site and browser cache.
Check that no other plugin is dequeuing styles — temporarily disable other WooCommerce plugins.

I'm seeing duplicate add-to-cart buttons or wishlist icons.

This usually happens when your theme or another plugin is also hooking into WooCommerce product loops. AcoDesign Product Grid’s compatibility layer attempts to remove duplicate hooks automatically. If the problem persists, identify the conflicting plugin and contact support.

The carousel isn't sliding.

Ensure `swiper-js` is loading — check browser console for errors.
Verify jQuery is loaded (required dependency).
Check for JavaScript errors from other plugins that might be breaking the Swiper initialization.

Videos aren't playing.

Ensure the video URL is a direct link to an MP4 or WebM file (not a page or embed).
Check browser console for CORS errors if the video is hosted on a different domain.
Verify the **Video Playback Mode** is set correctly (autoplay vs. hover).

The Quick View modal doesn't show variation swatches.

Ensure **Variation Swatches for WooCommerce** is installed. ACO Product Grid forces CFVSW assets on all frontend pages to support swatches inside modals.

🔒 Data & Privacy

Does the plugin store personal data?

The plugin stores:

– **Wishlist items:** Linked to user accounts (user meta) or cookies (guests).

– **Compare items:** Linked to user accounts (user meta) or cookies (guests).

– **Grid column preference:** In browser localStorage only.

No personal data is sent to external servers except license validation (domain URL and license key only).

What happens if I uninstall the plugin?

By default, all settings and data are preserved. If you enable **General → Delete on Uninstall**, all plugin data is permanently removed when you delete the plugin.

💳 Purchasing & Upgrades

How do I upgrade from the free version?

There is no free version. You can purchase a license at AcoDesign Product Grid – ACO DEV. After purchase, install the plugin, activate your license key, and the full feature set is immediately available.

Will I receive updates automatically?

Yes. The plugin checks for updates against the ACO Design license server and notifies you in the WordPress dashboard, just like plugins from WordPress.org. Updates require an active license.

Is there a refund policy?

Please refer to the ACO Design website at https://acodesign.dev for the current refund and terms policy.

Can't find your answer?

Our support team is ready to help you