Back to Flatsome – Responsive WooCommerce Theme
Flatsome – Responsive WooCommerce Theme changelog
Release notes for every version we have on record, newest first.
Latest 3.20.12
40 versions
3.20.12 Latest 1 new1 improved5 fixed
New
- WooCommerce 11.2 compatibility.
Improved
- Removed an unnecessary variation data query for product page swatches when "Use variation images" is disabled.
Fixed
- Image swatches showing a placeholder for variations whose image was removed by the WooCommerce 11.2 database update.
- Lazy loaded images not loading in the WooCommerce product gallery after selecting a variation with a variation gallery.
- Live search showing no image for variations without their own image when searching by SKU.
- Live search spinner turning off while a search was still running.
- Product gallery slider no longer working after selecting a variation with multiple images in the WooCommerce variation gallery.
3.20.11 1 improved1 fixed1 security
Improved
- Prevented a memory exhaustion fatal error with the sale bubble percentage on variable products, caused by a change in WooCommerce 11.1 core.
Fixed
- Stored XSS via data-* and title attributes in countdown, scroll-to, lightbox, and tooltip behaviors.
Security
- Note: This release contains an enhanced security measure. We recommend updating your sites promptly for optimal protection.
3.20.10 1 new2 improved
New
- WooCommerce 11.1 compatibility.
Improved
- UX Block title AJAX endpoint security.
- Security enhancement for the version info iframe to prevent Reflected XSS via URL parameters.
3.20.9 1 new3 fixed
New
- WooCommerce 11 compatibility.
Fixed
- UX Builder showing a server error on some server setups.
- Possible addQty is not a function error in the Composite Products integration when the theme WooCommerce script is not loaded.
- Possible fatal error during plugin updates when a third-party updater provides a non-string update package.
3.20.8 3 fixed1 security
Fixed
- Flatsome Studio & Setup Wizard WP 7.0+ import checkbox & button styling.
- Quantity selector buttons not working when step value is set to 'any'.
- Missing alt tags on product gallery thumbnails.
Security
- Note: This release contains an enhanced security measure. We recommend updating your sites promptly for optimal protection.
3.20.7 2 new1 improved
New
- WordPress 7.0 compatibility.
- WooCommerce 10.8 compatibility.
Improved
- Ukrainian language files.
3.20.6 1 fixed1 security
Fixed
- Instagram Feed: Missing closing quote on follow link target attribute.
Security
- Note: This release contains an enhanced security measure. We recommend updating your sites promptly for optimal protection.
3.20.5 1 new
New
- WooCommerce 10.5 compatibility.
3.20.4 2 new1 improved1 fixed
New
- WordPress 6.9 compatibility.
- WooCommerce 10.4 compatibility.
Improved
- Google Fonts list.
Fixed
- Swatches: Missing placeholder images in admin edit attributes.
3.20.3 1 new
New
- WooCommerce 10.3 compatibility.
3.20.2 1 new4 fixed
New
- WooCommerce 10.2 compatibility.
Fixed
- PHP Warning undefined variable $class in contact element.
- Turkish translation improved entities for escaping.
- WooCommerce layered dropdown filtering in off-canvas sidebar.
- Accordion toggle icon size in a widget.
3.20.1 1 improved1 fixed
Improved
- Google Fonts list.
Fixed
- Prevent PHP error when WooCommerce brands is disabled by code.
3.20.0 19 new26 improved21 fixed1 changed
New
- WCAG 2.2 frontend accessibility updates.
- WooCommerce 10.1 compatibility.
- Catalog empty star rating option.
- Added alt text support for Instagram images and product thumbnails (accessibility).
- Added Flatsome_Icon class for icon handling and payment icon support.
- Added Grid multi-gallery support.
- Added new a11y behavior to theme scripts (accessibility).
- Added tooltip show/hide option to the follow and share global elements.
- Added tooltip show/hide option to the follow, share and team member shortcode elements.
- Banner link aria-label option.
- Lottie link aria-label option.
- Cart coupon form position option.
- Category filter overlay position option (left/right/center).
- Improved accessibility for swatches.
- Improved SVG icons for accessibility.
- Option to disable MediaElement script and CSS.
- Single product page (mobile) filter overlay position option (left/right/center).
- Swatches: Option to make out-of-stock items display inactive in shop loop.
- Added webp and avif image lightbox support.
Improved
- Added a new license tab to the admin panel.
- Added support for MP4 and youtu.be video links in the product video section.
- Clarified the message displayed when a purchase code is already registered.
- Clarified theme registration confirmation message.
- Improved checkout steps (accessibility).
- Improved dynamic icon generation using get_flatsome_icon function throughout the theme.
- Improved handling of HTML attributes for roles and ARIA in helper functions.
- Improved HTML attributes handling in flatsome_html_atts function with updated support for aria-, class, rel, and role attributes (accessibility).
- Improved keyboard navigation and focus management for swatches (accessibility).
- Improved overall accessibility in elements and templates.
- Improved styling for active and hover states in vertical fly-out navigation menu.
- Scroll for more now scrolls to the next sibling element.
- Show brand meta data in quick view.
- Updated default secondary and success color darkness (accessibility).
- Various CSS improvements.
- Vertical menu is now fully keyboard accessible.
- Don't load password meter script when WooCommerce registration is disabled with login lightbox.
- Deprecated global Flatsome.cookie in favor of Flatsome.Cookies JS function.
- Deprecated ux_builder_page_row_actions() in favor of ux_builder_row_actions().
- Flatsome-cookie-notice.js file location from /inc/extensions/flatsome-cookie-notice/ to assets/js/extensions/.
- Flatsome-live-search.js file location from /inc/extensions/flatsome-live-search/ to assets/js/extensions/.
- Updated button, icon, and navigation markup to use ARIA attribute methods.
- Updated login/register form headings from h3 to h2 for better semantic structure.
- Updated various elements to use new color and icon systems for consistency (accessibility).
- Added flatsome-header-unsticky event.
- Added flatsome_ajax_search_products_by_sku_search_meta_query_args filter.
Fixed
- Added missing "Edit with UX Builder" links for supported post types.
- CSS string in Contact Form 7 presets tab.
- Don't open the video lightbox in UX Builder.
- Fixed accessibility and structure of product swatches and quick view button.
- Fixed accessibility issues with SVG icons and lightbox buttons.
- Fixed cookie notice focus and keyboard accessibility.
- Incorrect default color and style for header button 2.
- JQuery deprecations.
- Login popup template in DOM if account element is not added to the header.
- Menu items misorientation from the Advanced Editor Tools plugin.
- PHP 8.4 notice, implicitly marking parameter as nullable is deprecated.
- PHP notice: Automatic conversion of false to array is deprecated, in the setup wizard.
- PHP notice: Trying to access array offset on value of type bool on menu icon that does not exist anymore.
- Prevented slides in grid column from stacking before the slider behavior is fully loaded.
- Product item price styling in mini cart dropdown when quantity is enabled.
- Slider non-visible focusable children (accessibility).
- Swatches: now reset if the default variation (set in backend) is not in stock.
- Add array initialization on tabs and panes to prevent implode() errors in tabs.
- Variation form reset variations button for swatches by keydown.
- Accordion content with masonry not properly laid out.
- Duplicated element on 404 page.
Changed
- Note: Accessibility improvements provided by the theme do not cover accessibility in the WordPress content management system and WooCommerce as a whole. Multiple variables, such as e.g., choice of colors, plugins, or custom code, can significantly impact frontend design and accessibility.
3.19.15 1 new
New
- WooCommerce 10.0 compatibility.
3.19.14 2 improved2 fixed1 removed
Improved
- Added ux_builder_ajax_posts_search_posts_get_posts_args filter.
- Added ux_builder_ajax_terms_search_terms_get_terms_args filter.
Fixed
- Duplicate store notice when move to top is enabled due to WooCommerce hook change.
- Setup wizard not accessible.
Removed
- Note: Option 'Move store notice to the top' is removed since this is now the default placement.
3.19.13 1 new3 fixed
New
- WooCommerce 9.9 compatibility.
Fixed
- Instagram admin username including dot and following digit.
- Instagram Feed element animation setting not applying to items.
- PHP notice: Translation loading for the flatsome domain was triggered too early.
3.19.12 1 new1 improved3 fixed
New
- WooCommerce 9.8 compatibility.
Improved
- Google Fonts list.
Fixed
- Default option value for max relative product count in customizer.
- Review submit form star spacing.
- Ensure integer is passed in for posts_per_page from max_related_products mod, fixing notices due to a bug in WooCommerce 9.7 core.
3.19.11 1 improved
Improved
- Refined focus visible Firefox fix on product gallery image link to ensure compatibility across all browsers without interfering with the gallery functionality.
3.19.10 2 new1 improved3 fixed
New
- WooCommerce 9.7 compatibility.
- Products list element class and visibility option.
Improved
- Removed wc_feature_woocommerce_brands_enabled condition check for brands.
Fixed
- Improved compatibility with PHP 7.4 by addressing an issue with the 'mixed' return type.
- Yoast reindex with CLI command when accordion is present.
- Focus visible styling on product gallery image link with Firefox.
3.19.9 1 new3 improved2 fixed
New
- WooCommerce 9.6 compatibility.
Improved
- Various CSS improvements.
- Deprecated flatsome_option() and flatsome_defaults() functions.
- Google Fonts list.
Fixed
- H4 tag size on mobile devices.
- WooCommerce 'Terms and conditions' string.
3.19.8 2 new5 improved1 fixed
New
- WooCommerce 9.5 compatibility.
- Added Wero payment icon.
Improved
- Added a validation check to ensure the JavaScript-inserted toggle button is not duplicated.
- Swatch list cache is now cleared when an order is canceled.
- Updated Mastercard payment icon.
- Various CSS improvements.
- Language files.
Fixed
- Resolved a $orderedby variable warning when using WooCommerce versions older than 9.4.
3.19.7 3 new6 improved4 fixed1 changed
New
- WordPress 6.7 compatibility.
- WooCommerce 9.4 compatibility.
- Option to show product brand on single product page (WooCommerce Core).
Improved
- Show register label in the sidebar account element if enabled.
- WPML translation with native editor compatibility.
- YITH Wishlist v4 improvements.
- Various CSS improvements.
- Google Fonts list.
- Language files.
Fixed
- Added additional parameters to the woocommerce_variation_option_name filter.
- Composite products integration did not load with lazy load images disabled.
- Header Contact element Lighthouse Link not crawlable entry.
- Support for private and hidden products in the quick view AJAX request.
Changed
- Note: Product brands ships with WooCommerce 9.4 core and is not enabled by default in this version.
3.19.6 1 new1 improved1 fixed
New
- WooCommerce 9.3 compatibility.
Improved
- Language files.
Fixed
- Exit UX Builder redirected to post list in some cases.
3.19.5 1 new6 improved1 fixed
New
- WooCommerce 9.2 compatibility.
Improved
- Improved cleanup of cron events.
- Strengthen sticky add to cart $product global check.
- Scroll to product element if variations form is not found for sticky add to cart select options button.
- Various CSS improvements.
- Google Fonts list.
- Language files.
Fixed
- WP 6.6 Block editor 'Edit with UX Builder'.
3.19.4 1 new2 improved2 fixed1 changed
New
- WooCommerce 9.1 compatibility.
Improved
- Prevented cart coupon form from being hidden with WC Stripe Payment Gateway plugin.
- Various CSS improvements.
Fixed
- Custom product single product hooks did not apply.
- Product zoom in RTL.
Changed
- Note: The cart coupon class name is changed from checkout_coupon to ux-cart-coupon for plugin compatibility.
3.19.3 2 fixed1 changed
Fixed
- Custom product gallery: Vertical and 2-column style rendered default layout.
- Background images displayed less sharply on mobile in some cases.
Changed
- Reverted: Heading text wrapping (balanced).
3.19.2 1 improved2 fixed
Improved
- Support plain URL as bg attribute value for banner & section.
Fixed
- Resolved an issue where price filter and sorting were disabled with prices enabled in catalog mode.
- Banner & Section background position in combination with picture tag.
3.19.1 1 improved2 fixed
Improved
- Language files.
Fixed
- Banner & Section background position when using certain element alignment options.
- Width of custom nodes in single product form cart.
3.19.0 8 new19 improved12 fixed1 security3 changed
New
- WooCommerce 9.0 compatibility.
- Product quick Buy Now button.
- Product sticky gallery option.
- Icon and letter case options for Header Button 1 & Button 2 elements.
- Sorting option for product live search results.
- Threads follow link option.
- Threads share link option.
- Threads (social media) icon.
Improved
- Added most commonly used brand taxonomies in the shop archive check function.
- An array of catalog mode improvements.
- Improved accessibility on various elements.
- Improved heading text wrapping.
- Mini cart JavaScript event improvements.
- Only add skip-lazy class on product gallery images when Jetpack lazy load is enabled.
- Renamed blog post 'Custom Posts' option label to 'Posts' for clarity.
- Skip the main product gallery image from lazy loading.
- Updated cart contents count method.
- Various CSS improvements.
- Banner & Section backgrounds now use an img tag.
- Instance() methods deprecated in favor of get_instance().
- Moved cookie function from global scope to Flatsome object.
- Pjax items are now declared per entry in the experimental_flatsome_pjax filter.
- Added flatsome_show_buy_now_button filter.
- Added new flatsome_product_box_actions_classes filter.
- Added new flatsome_product_box_classes filter.
- Added new flatsome_product_box_image_classes filter.
- Added new flatsome_product_box_text_classes filter.
Fixed
- Auto open mini cart drawer on tablet/mobile in combination with mini cart dropdown on desktop.
- Blog posts element pagination with offset value produced incorrect results.
- Corrected Whislist text string translation domain.
- Custom cart icon size attributes.
- Default read more button style in the Blog posts element.
- Header main HTML elements did not display on mobile view.
- Product review stars in content small template did not display.
- Resolved issue where the reveal-icon class for a button was being added when no icon was assigned.
- Swatches default selected color is secondary and now correctly reflects custom secondary color value.
- Tag line color with header light text.
- Visibility setting did not affect shortcode pagination controls.
- Wishlist-added class in combination with YITH "Show Remove from list" option.
Security
- Note: This release contains an enhanced security measure. We recommend updating your sites promptly for optimal protection.
Changed
- Note: Minimum required PHP version 7.4.
- Note: Minimum required WooCommerce version 8.3.
- Note: Minimum required WP version 6.4.
3.18.7 2 new2 improved2 fixed
New
- WooCommerce 8.8 compatibility.
- Added new .l10n.php translation file format.
Improved
- Improved mini cart drawer rendering performance.
- Language files.
Fixed
- Element pagination with offset value produced incorrect results.
- Free shipping bar did not consider "Apply minimum order rule before coupon discount" option and always applied minimum order rule before coupon logic.
3.18.6 1 new2 improved1 fixed
New
- WooCommerce 8.7 compatibility.
Improved
- Google Fonts list.
- Language files.
Fixed
- Corrected lightbox menu item text in admin bar options to 'Drawer & Lightbox'.
3.18.5 1 new2 improved3 fixed
New
- Added a button to clear typography cache and locally downloaded files.
Improved
- Upgraded the format of font files to woff2 from woff.
- Language files.
Fixed
- Addressed an issue where locally served font files were returning 403 errors in some cases due to irregular Google font API responses.
- Image lazy loading on WC Composite components.
- Hotspot tooltip on a mobile device.
3.18.4 1 new4 improved3 fixed
New
- WooCommerce 8.6 compatibility.
Improved
- Added check for global $product object existence in flatsome_sticky_add_to_cart_template function.
- Improved WPML configuration.
- Google Fonts list.
- Language files.
Fixed
- Improved handling of non-existent attachment images.
- Shop category header title color with dark content.
- Undefined array key "limit" PHP warning in some cases.
3.18.3 1 new8 improved1 fixed
New
- WooCommerce 8.5 compatibility.
Improved
- Free shipping bar was displayed when only virtual products were in the cart.
- Header newsletter title setting stays now visible if a custom block is chosen.
- Improved mini cart loading state styles.
- Improved shortcode image detection for sitemap.
- Mini cart qty input improvements.
- Sticky add to cart only consider the first visible Add to Cart button as intersection.
- Various CSS improvements.
- Language files.
Fixed
- Free shipping threshold currency conversion issue in some cases.
3.18.2 7 improved5 fixed
Improved
- Mini Cart Quantity: Automatically remove items from the cart when their quantity is reduced to zero.
- Mini Cart Quantity: Validation for user manual input.
- Refined the description of the 'maintenance bypass key' option for better understanding.
- Various CSS improvements.
- Added flatsome_is_blog_archive filter.
- Added flatsome_is_shop_archive filter.
- Recommended PHP version 8.1 or higher (8.0 EOL) for better performance and security.
Fixed
- Altered Widget link color and link color hover settings, they no longer target the mini cart widget.
- AJAX 'Add to Cart': Enhanced compatibility with different plugins to prevent conflicts.
- Rectified the width issue of Login lightbox with register panel layout.
- Corrected the improper display of Mobile product sidebar on certain product layouts.
- Show Page Layout widget in Classic Editor when Block Editor is disabled for pages.
3.18.1 3 improved4 fixed1 changed
Improved
- Made theme colors available through theme CSS custom properties (see note).
- Various CSS improvements.
- Language files.
Fixed
- Ajax add to cart with 'Any...' variation setup.
- Images weren't imported correctly from Flatsome Studio in some cases.
- An error occurred in the Page Layout section in the Block Editor in some cases.
- Mini cart content after Pjax filtering.
Changed
- Note: In certain cases, such as when WP Global styles were disabled by a performance plugin, custom theme colors defaulted to their original values.
3.18.0 47 new22 improved11 fixed
New
- WooCommerce 8.3 compatibility.
- Debuting tailored Pjax functionality. Facilitates ajax-driven navigation & filtering (optional).
- Shop: AJAX for product category widget, filter widgets & sorting (optional).
- Builder: Color Eyedropper tool for effortless screen color picking.
- Scroll to the top after Pjax navigation option.
- Mini cart: Quantity input (ajax-driven) option.
- Mini cart: Free shipping bar option.
- Mini cart: Empty cart icon & return to shop button.
- Mini cart drawer: Show cross-sells option.
- Mini cart drawer: Sticky footer option.
- Cart: Free shipping bar option.
- Checkout: Free shipping bar option.
- Added advanced menu section 'Content Delivery'.
- Blog pagination type choice (Normal/AJAX).
- WooCommerce pagination type choice (Normal/AJAX/Infinite scroll).
- Blog posts element pagination (pagination links, load more, prev/next) on row, masonry & grid layout.
- Blog posts element pagination alignment.
- Blog posts element pagination ID and Class field.
- Blog posts element pagination position.
- Products element pagination (pagination links, load more, prev/next) on row, masonry & grid layout.
- Products element pagination alignment.
- Products element pagination ID and Class field.
- Products element pagination position.
- FAQ schema support to accordions, for improving SEO and search result visibility (optional).
- Lottie scroll action type option (seek, play, playOnce).
- Single product gallery type option (slide, fade).
- Custom accordion anchor.
- Custom tab anchors.
- Maintenance mode: Body class.
- Maintenance mode: Bypass by key.
- Maintenance mode: Exclude by role (default).
- Option to display WhatsApp among the Header Contact fields.
- Option to set Off-canvas / Drawer width.
- Option to set Off-canvas Cart Drawer width.
- Select theme colors in the Block Editor.
- Shop catalog ordering enable/disable option.
- Shop catalog result count enable/disable option.
- Smoother theme scroll-to animation.
- Title link rel option.
- Title link target option.
- Tooltip color & background color options.
- UX Blocks admin category filter and column.
- Added 2 header block slots.
- Bullet list cross icon.
- X (social media) icon.
- X follow link option.
- X share link option.
Improved
- Optimized code execution for global Ajax requests.
- Added 'Manage your licenses' link in the setup wizard register step.
- Added all theme icons in the builder icon value dropdown.
- Added comments template to all page templates.
- AJAX add to cart scroll to notice on notice.
- Changed mini cart heading tag from h4 to span.
- If using lightbox login, notices will now show inside the lightbox login/register form.
- Improved shop swatch reset limited reset logic.
- Improved the theme logo in the backend.
- Improved various customizer options visibility (hiding options that depend on other settings).
- Improved WooCommerce notices on transparent header.
- Improved WPML configuration.
- Quantity button alignment in shop loop products.
- Remove the default sliding animations on off-canvas buttons.
- Removed title attribute from WooCommerce gallery images to prevent the display of image filenames in the native tooltip.
- Sticky add to cart functionality for stacked layouts.
- Support iframed Block Editor.
- Swatches/shop: Improved cache clearance.
- Use custom CSS properties for theme colors.
- Various customizer options are reordered more logically.
- Builder: Improved layout when php notices appear.
- Various CSS improvements.
Fixed
- B2B for WooCommerce Ajax add to cart product pricing.
- Vertical menu dropdown not same height as fly out on Safari.
- Blog posts excerpt trimming issue to ensure accurate length and avoid duplicate ellipses.
- Ensure Flickity is initialized before attempting to destroy.
- Header HTML slots did not render shortcode in preview in some cases.
- Hide-for-small & hide-for-medium classes did not take effect in drawers.
- List item indentation in UX Block menu dropdown.
- PHP 8.2 deprecations.
- Position of slider arrows (circle/outside style) and its reveal animation.
- Review count on related and upsell products on a single product page.
- Swatches/shop: out-of-stock class added when only one variation was out of stock.
3.17.7 1 new4 improved8 fixed
New
- WooCommerce 8.1 compatibility.
Improved
- Body overflow prevention.
- Don't lazy-load images with high fetch priority.
- Disabled ajax add to cart on composite products.
- Language files.
Fixed
- Attach post when uploading images in UX Builder.
- Copy as Shortcode on custom product page product elements.
- Don't auto play sliders on mobile after scrolling if not enabled.
- Don't redirect to product when clicking on swatches in UX Builder.
- Image lazy-loading failed in some cases on WordPress 6.3.
- Non-bullet styled list item indentation in UX Block menu dropdown.
- Removed padding on text with color inside square and circle Text Box elements.
- Responsive Stack gap with "0" as value.
3.17.6 1 security
Security
- This release contains an enhanced security measure. We recommend updating your sites promptly for optimal protection.
3.17.5 1 improved3 fixed
Improved
- Language files.
Fixed
- Resolved an issue where the header cart item element was not updating in some cases.
- Toggling of sticky-hide-on-scroll active class.
- Banner zoom long hover style.
