Troubleshooting Common YITH WooCommerce Wishlist Display and Styling Issues
Content
If you've installed the YITH WooCommerce Wishlist plugin and find that the buttons aren't showing up, look broken, or don't match your theme's style, you're not alone. This is a frequent point of confusion for users. This guide will walk you through the most common causes and their solutions, based on community reports and resolutions.
Why Do These Display Issues Happen?
Display problems with the wishlist button typically stem from one of three areas:
- Plugin Settings: The button's visibility is controlled by specific options that might be disabled by default.
- Theme & Plugin Conflicts: Your theme or another plugin might be applying CSS styles that override the wishlist's appearance or blocking its scripts from loading.
- Caching: Aggressive caching can sometimes serve old versions of the site's styling to guests or new users.
Step-by-Step Troubleshooting
1. Check the Basic Settings First
Before diving into complex fixes, always verify your plugin's configuration. Navigate to WP Dashboard → YITH → Wishlist → Add to Wishlist options.
- Under Loop settings, ensure "Show 'Add to wishlist' in loop" is enabled and select your desired position (e.g., After 'Add to cart').
- Under Product page settings, configure the "Position of 'Add to wishlist' on product page".
Save any changes and check your site again.
2. Perform a Conflict Test
This is the most critical step for identifying the root cause.
- Switch to a Default Theme: Temporarily activate a standard WordPress theme like Twenty Twenty-Three. If the wishlist button appears correctly, the issue is likely a conflict with your main theme's styling or functionality. The YITH WooCommerce Wishlist team often suggests this as a first diagnostic step.
- Disable Other Plugins: If the issue persists with a default theme, deactivate all other plugins except for WooCommerce and YITH Wishlist. Reactivate them one by one to identify which one is causing the conflict. Common culprits include aggressive caching, minification, or security plugins.
3. Clear All Caches
If the button displays correctly for logged-in users (like administrators) but not for guests, caching is a probable cause. Clear your:
- Browser cache
- WordPress caching plugin cache (e.g., W3 Total Cache, WP Rocket)
- Server-level cache (e.g., Varnish, CDN cache)
4. Investigate Missing Assets
In some cases, the theme or a plugin might prevent the wishlist's CSS and JavaScript files from loading. As seen in one support thread, this can cause buttons to look unstyled and non-functional. Use your browser's developer tools (F12) to check if files from yith-woocommerce-wishlist are being loaded. If they are missing, the conflict test above should help find what is blocking them.
5. Apply Custom CSS (For Style Overrides)
If the button is visible but has minor style issues (e.g., overlapping elements, incorrect color), you can often fix it with custom CSS. The YITH support team has provided CSS snippets to resolve specific bugs, such as one that caused duplicate icons to appear.
You can add custom CSS in Appearance → Customize → Additional CSS. For example:
.yith-wcwl-add-button span {
display: none !important;
}
Note: Always test CSS changes on a staging site first.
6. Template Overrides (Advanced)
For more control over the wishlist table's structure (e.g., column headers), you can override the plugin's template files in your theme. Copy the file from wp-content/plugins/yith-woocommerce-wishlist/templates/ to a yith-woocommerce-wishlist/ folder within your child theme directory and modify it there. This ensures your changes are not overwritten by plugin updates.
When to Seek Further Help
If you have performed all these steps and the issue remains, the problem may require more specific debugging. When seeking help in forums, be prepared to provide:
- A direct link to a page where the problem is visible.
- A list of your active plugins, theme name, and version.
- Screenshots or a screen recording clearly illustrating the issue.
Remember, the appearance of the wishlist on the official YITH demo is often achieved using their proprietary theme (Proteo). It is normal for the styling to look different on other themes, and achieving an exact match may require significant custom CSS work.
Related Support Threads Support
-
Not displaying correctlyhttps://wordpress.org/support/topic/not-displaying-correctly-19/
-
Plugin not working with Storefront?https://wordpress.org/support/topic/plugin-not-working-with-storefront-2/
-
Setting display problemhttps://wordpress.org/support/topic/setting-display-problem/
-
BUG in Wishlist plugin (free version) didnt check the pro yethttps://wordpress.org/support/topic/bug-in-wishlist-plugin-free-version-didnt-check-the-pro-yet/
-
about premium pluginhttps://wordpress.org/support/topic/about-premium-plugin/
-
Elessi and yith Bug Installhttps://wordpress.org/support/topic/elessi-and-yith-bug-install/
-
Plugin settings not reflecting on the page.https://wordpress.org/support/topic/plugin-settings-not-reflecting-on-the-page/
-
it conflicts with elementor pro.https://wordpress.org/support/topic/it-conflicts-with-elementor-pro/
-
Inquiry on Stripe’s seamless checkout and recurring shipping costshttps://wordpress.org/support/topic/inquiry-on-stripes-seamless-checkout-and-recurring-shipping-costs/
-
amp supporthttps://wordpress.org/support/topic/amp-support-94/
-
Problème affichage tableau résultat wishlisthttps://wordpress.org/support/topic/probleme-affichage-tableau-resultat-wishlist/
-
some error with the plugin and also need some customisationhttps://wordpress.org/support/topic/some-error-with-the-plugin-and-also-need-some-customisation/
-
Wishlist analytics (& premium Dokan integration)https://wordpress.org/support/topic/wishlist-analytics-premium-dokan-integration/
-
Wishlist Plugin Not Workinghttps://wordpress.org/support/topic/wishlist-plugin-not-working/
-
Infinity Scroll on Listing Pageshttps://wordpress.org/support/topic/infinity-scroll-on-listing-pages/
-
Broken style layouthttps://wordpress.org/support/topic/broken-style-layout/
-
Endless wait on single product pagehttps://wordpress.org/support/topic/endless-wait-on-single-product-page/
-
Product analytics in free versionhttps://wordpress.org/support/topic/product-analytics-in-free-version/
-
VERSION 4.6.5 CAUSING GLARING ISSUEShttps://wordpress.org/support/topic/version-4-6-5-causing-glaring-issues/
-
Wishlist button not styled for guest usershttps://wordpress.org/support/topic/wishlist-button-not-styled-for-guest-users/
-
O plugin não funciona para todos produtos do sitehttps://wordpress.org/support/topic/o-plugin-nao-funciona-para-todos-produtos-do-site/
-
Does This Plugin Require Users to Sign Up, Or Can They Just Be Guests?https://wordpress.org/support/topic/does-this-plugin-require-users-to-sign-up-or-can-they-just-be-guests-4/