Flatsome Multi-Purpose Responsive WooCommerce Theme

3.20.4 (11.12.25)

• NEW: WordPress 6.9 compatibility.
• NEW: WooCommerce 10.4 compatibility.
• FIXED: Swatches: Missing placeholder images in admin edit attributes.
• UPDATED: Google Fonts list.

3.20.3 (24.10.25)

• NEW: WooCommerce 10.3 compatibility.

3.20.2 (19.09.25)

• NEW: WooCommerce 10.2 compatibility.
• FIXED: PHP Warning undefined variable $class in contact element.
• FIXED: Turkish translation improved entities for escaping.
• FIXED: WooCommerce layered dropdown filtering in off-canvas sidebar.
• FIXED: Accordion toggle icon size in a widget.

3.20.1 (15.08.25)

• FIXED: Prevent PHP error when WooCommerce brands is disabled by code.
• UPDATED: Google Fonts list.

3.20.0 (13.08.25)

• NEW: WCAG 2.2 frontend accessibility updates.
• NEW: WooCommerce 10.1 compatibility.
• NEW: Catalog empty star rating option.
• NEW: Added alt text support for Instagram images and product thumbnails (accessibility).
• NEW: Added Flatsome_Icon class for icon handling and payment icon support.
• NEW: Added Grid multi-gallery support.
• NEW: Added new a11y behavior to theme scripts (accessibility).
• NEW: Added tooltip show/hide option to the follow and share global elements.
• NEW: Added tooltip show/hide option to the follow, share and team member shortcode elements.
• NEW: Banner link aria-label option.
• NEW: Lottie link aria-label option.
• NEW: Cart coupon form position option.
• NEW: Category filter overlay position option (left/right/center).
• NEW: Improved accessibility for swatches.
• NEW: Improved SVG icons for accessibility.
• NEW: Option to disable MediaElement script and CSS.
• NEW: Single product page (mobile) filter overlay position option (left/right/center).
• NEW: Swatches: Option to make out-of-stock items display inactive in shop loop.
• NEW: Added webp and avif image lightbox support.
• ENHANCEMENT: Added a new license tab to the admin panel.
• ENHANCEMENT: Added support for MP4 and youtu.be video links in the product video section.
• ENHANCEMENT: Clarified the message displayed when a purchase code is already registered.
• ENHANCEMENT: Clarified theme registration confirmation message.
• ENHANCEMENT: Improved checkout steps (accessibility).
• ENHANCEMENT: Improved dynamic icon generation using get_flatsome_icon function throughout the theme.
• ENHANCEMENT: Improved handling of HTML attributes for roles and ARIA in helper functions.
• ENHANCEMENT: Improved HTML attributes handling in flatsome_html_atts function with updated support for aria-, class, rel, and role attributes (accessibility).
• ENHANCEMENT: Improved keyboard navigation and focus management for swatches (accessibility).
• ENHANCEMENT: Improved overall accessibility in elements and templates.
• ENHANCEMENT: Improved styling for active and hover states in vertical fly-out navigation menu.
• ENHANCEMENT: Scroll for more now scrolls to the next sibling element.
• ENHANCEMENT: Show brand meta data in quick view.
• ENHANCEMENT: Updated default secondary and success color darkness (accessibility).
• ENHANCEMENT: Various CSS improvements.
• FIXED: Added missing "Edit with UX Builder" links for supported post types.
• FIXED: CSS string in Contact Form 7 presets tab.
• FIXED: Don't open the video lightbox in UX Builder.
• FIXED: Fixed accessibility and structure of product swatches and quick view button.
• FIXED: Fixed accessibility issues with SVG icons and lightbox buttons.
• FIXED: Fixed cookie notice focus and keyboard accessibility.
• FIXED: Incorrect default color and style for header button 2.
• FIXED: jQuery deprecations.
• FIXED: Login popup template in DOM if account element is not added to the header.
• FIXED: Menu items misorientation from the Advanced Editor Tools plugin.
• FIXED: PHP 8.4 notice, implicitly marking parameter as nullable is deprecated.
• FIXED: PHP notice: Automatic conversion of false to array is deprecated, in the setup wizard.
• FIXED: PHP notice: Trying to access array offset on value of type bool on menu icon that does not exist anymore.
• FIXED: Prevented slides in grid column from stacking before the slider behavior is fully loaded.
• FIXED: Product item price styling in mini cart dropdown when quantity is enabled.
• FIXED: Slider non-visible focusable children (accessibility).
• FIXED: Swatches: now reset if the default variation (set in backend) is not in stock.
• FIXED: Add array initialization on tabs and panes to prevent implode() errors in tabs.
• FIXED: Variation form reset variations button for swatches by keydown.
• FIXED: Accordion content with masonry not properly laid out.
• FIXED: Duplicated <main> element on 404 page.
• CHANGED: Deprecated global Flatsome.cookie in favor of Flatsome.Cookies JS function.
• CHANGED: Deprecated ux_builder_page_row_actions() in favor of ux_builder_row_actions().
• CHANGED: flatsome-cookie-notice.js file location updated.
• CHANGED: flatsome-live-search.js file location updated.
• CHANGED: Updated button, icon, and navigation markup to use ARIA attribute methods.
• CHANGED: Updated login/register form headings from h3 to h2 for better semantic structure.
• CHANGED: Updated various elements to use new color and icon systems for consistency (accessibility).
• DEV: Added flatsome-header-unsticky event.
• DEV: Added flatsome_ajax_search_products_by_sku_search_meta_query_args filter.

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 choice of colors, plugins, or custom code, can significantly impact frontend design and accessibility.

3.19.15 (14.07.25)

• NEW: WooCommerce 10.0 compatibility.

3.19.14 (12.06.25)

• FIXED: Duplicate store notice when move to top is enabled due to WooCommerce hook change.
• FIXED: Setup wizard not accessible.
• DEV: Added ux_builder_ajax_posts_search_posts_get_posts_args filter.
• DEV: Added ux_builder_ajax_terms_search_terms_get_terms_args filter.

Note: Option 'Move store notice to the top' is removed since this is now the default placement.

3.19.13 (10.06.25)

• NEW: WooCommerce 9.9 compatibility.
• FIXED: Instagram admin username including dot and following digit.
• FIXED: Instagram Feed element animation setting not applying to items.
• FIXED: PHP notice: Translation loading for the flatsome domain was triggered too early.

3.19.12 (10.04.25)

• NEW: WooCommerce 9.8 compatibility.
• FIXED: Default option value for max relative product count in customizer.
• FIXED: Review submit form star spacing.
• FIXED: 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.
• UPDATED: Google Fonts list.

3.19.11 (26.02.25)

• CHANGED: 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 (24.02.25)

• NEW: WooCommerce 9.7 compatibility.
• NEW: Products list element class and visibility option.
• FIXED: Improved compatibility with PHP 7.4 by addressing an issue with the 'mixed' return type.
• FIXED: Yoast reindex with CLI command when accordion is present.
• FIXED: Focus visible styling on product gallery image link with FireFox.
• CHANGED: Removed wc_feature_woocommerce_brands_enabled condition check for brands.

3.19.9 (22.01.25)

• NEW: WooCommerce 9.6 compatibility.
• ENHANCEMENT: Various CSS improvements.
• FIXED: h4 tag size on mobile devices.
• FIXED: WooCommerce 'Terms and conditions' string.
• CHANGED: Deprecated flatsome_option() and flatsome_defaults() functions.
• UPDATED: Google Fonts list.

3.19.8 (17.11.24)

• NEW: WooCommerce 9.5 compatibility.
• NEW: Added Wero payment icon.
• ENHANCEMENT: Validation to ensure the JavaScript-inserted toggle button is not duplicated.
• ENHANCEMENT: Swatch list cache cleared when an order is canceled.
• ENHANCEMENT: Updated Mastercard payment icon.
• FIXED: Resolved a $orderedby variable warning when using WooCommerce versions older than 9.4.
• UPDATED: Language files.

3.19.7 (12.11.24)

• NEW: WordPress 6.7 compatibility.
• NEW: WooCommerce 9.4 compatibility.
• NEW: Option to show product brand on single product page (WooCommerce Core).
• ENHANCEMENT: Show register label in the sidebar account element if enabled.
• ENHANCEMENT: WPML translation with native editor compatibility.
• ENHANCEMENT: YITH Wishlist v4 improvements.
• ENHANCEMENT: Various CSS improvements.
• FIXED: Added additional parameters to the woocommerce_variation_option_name filter.
• FIXED: Composite products integration did not load with lazy load images disabled.
• FIXED: Header Contact element Lighthouse Link not crawlable entry.
• FIXED: Support for private and hidden products in the quick view AJAX request.
• UPDATED: Google Fonts list.
• UPDATED: Language files.

3.18.7 (18.04.24)

• NEW: WooCommerce 8.8 compatibility.
• NEW: Added new .l10n.php translation file format.
• ENHANCEMENT: Improved mini cart drawer rendering performance.
• FIXED: Element pagination with offset value produced incorrect results.
• FIXED: Free shipping bar did not consider "Apply minimum order rule before coupon discount" option.
• UPDATED: Language files.

3.18.6 (20.03.24)

• NEW: WooCommerce 8.7 compatibility.
• FIXED: Corrected lightbox menu item text in admin bar options to 'Drawer & Lightbox'.
• UPDATED: Google Fonts list.
• UPDATED: Language files.

3.18.5 (16.03.24)

• NEW: Added a button to clear typography cache and locally downloaded files.
• FIXED: 403 errors when serving locally font files due to irregular Google font API responses.
• FIXED: Image lazy loading on WC Composite components.
• FIXED: Hotspot tooltip on a mobile device.
• CHANGED: Upgraded font files to woff2 from woff.
• UPDATED: Language files.

3.18.4 (16.02.24)

• NEW: WooCommerce 8.6 compatibility.
• ENHANCEMENT: Global $product existence check in flatsome_sticky_add_to_cart_template function.
• ENHANCEMENT: Improved WPML configuration.
• FIXED: Handling of non-existent attachment images.
• FIXED: Shop category header title color with dark content.
• FIXED: Undefined array key "limit" PHP warning in some cases.
• UPDATED: Google Fonts list.
• UPDATED: Language files.

3.18.3 (09.01.24)

• NEW: WooCommerce 8.5 compatibility.
• ENHANCEMENT: Free shipping bar displayed when virtual products only in cart.
• ENHANCEMENT: Header newsletter title setting remains visible with custom block.
• ENHANCEMENT: Mini cart loading state styles.
• ENHANCEMENT: Shortcode image detection for sitemap.
• ENHANCEMENT: Mini cart qty input improvements.
• ENHANCEMENT: Sticky add to cart only considers first visible Add to Cart button as intersection.
• ENHANCEMENT: Various CSS improvements.
• FIXED: Free shipping threshold currency conversion issue in some cases.
• UPDATED: Language files.

3.17.7 (12.09.23)

• NEW: WooCommerce 8.1 compatibility.
• ENHANCEMENT: Body overflow prevention.
• ENHANCEMENT: Don't lazy-load images with high fetch priority.
• FIXED: Attach post when uploading images in UX Builder.
• FIXED: Copy as Shortcode on custom product page product elements.

3.17.6 (07.08.23)

• NOTE: This release contains an enhanced security measure. We recommend updating promptly for protection.

3.17.5 (04.08.23)

• FIXED: Header cart item element not updating in some cases.
• FIXED: Toggling of sticky-hide-on-scroll active class.
• FIXED: Banner zoom long hover style.
• UPDATED: Language files.

3.17.4 (11.07.23)

• NEW: WooCommerce 7.9 compatibility.
• ENHANCEMENT: Improved WCML multi-currency support.
• FIXED: Google map Pegman & buttons placement.
• FIXED: Live search not showing results in some cases.
• FIXED: Sticky section on mobile.
• CHANGED: Copy as Shortcode: replaced navigator API with a prompt for reliability.

3.17.3 (23.06.23)

• FIXED: Scroll-to link with full URLs not navigating in some cases.
• FIXED: Icons alignment in the admin menu dropdown.
• FIXED: Apply Coupon button color.
• UPDATED: Language files.

3.17.2 (15.06.23)

• NEW: WooCommerce 7.8 compatibility.
• UPDATED: Google Fonts list.
• UPDATED: Language files.

3.17.1 (31.05.23)

• NEW: Lottie link options.
• NEW: Swatches/product: Disable deselect option.
• ENHANCEMENT: Improved no menu assigned message in Vertical Menu.
• ENHANCEMENT: Various CSS improvements.
• FIXED: Catalog sidebar sticky mode option visibility.
• FIXED: Flatsome-header-sticky event triggered more than once.
• FIXED: Left and right bounce in animations didn't start in some cases.
• FIXED: PHP 8.1 deprecated warning.
• FIXED: Scroll-to with numbers only; with special chars.
• FIXED: Single product pricing currency in Safari.
• FIXED: Swatches/shop: text-right alignment.
• FIXED: WP Rocket integration script version.
• UPDATED: Language files.

3.17.0 (25.04.23)

• NEW: Lottie Element (Bodymovin).
• NEW: AJAX add to cart buttons on single product page & quick view (optional).
• NEW: Lazy load Instagram feeds (optional).
• NEW: Header element Secondary Menu.
• NEW: Native CSS-based sticky columns.
• NEW: Per-page load offset calculation for optimized scroll-to.
• NEW: Sticky sidebar/column mode option.
• NEW: Swatches/shop: Reset limited swatches option.
• NEW: Auto open & scroll to accordion item per URL hash.
• NEW: Auto-scroll to tab per URL hash.
• NEW: Slider: Responsive slide width.
• NEW: Refactored follow and share links for customization.
• NEW: Refactored sticky column JavaScript.
• NEW: Lottie Path: Set the source path or upload a file.
• NEW: Lottie Animation Speed; Autoplay; Mouse behavior; Triggers.
• NEW: Lottie Start/Finish at X% Viewport; Play in Reverse; Start/End Animation at X%.
• NEW: Lottie Player Controls.
• NEW: Offset Type/Offset Value for scroll-to.
• NEW: Yoast & Rank Math: set primary term active category in WooCommerce widget.
• PERFORMANCE: Optimized code execution for global Ajax requests.
• ENHANCEMENT: Added license manage link in setup wizard; theme icons in builder; improved accessibility and translations.
• FIXED: Numerous fixes across builder, navigation, and compatibility.

3.17.0 to 3.17.x notable notes

These updates focus on performance improvements, better accessibility, and expanded widget and builder capabilities, including Pegman map adjustments, improved live search, and expanded SWATCH features.

3.16.8 (30.03.23)

• NEW: Instagram access tokens support; select connected Instagram account in UX Builder.
• CHANGED: Removed old Instagram scrape method.

3.16.7 (23.03.23)

• FIXED: Quantity buttons on cart not functioning after update to WooCommerce 7.5.

3.16.6 (14.02.23)

• NEW: WooCommerce 7.4 compatibility.
• UPDATED: Google Fonts list.
• ENHANCEMENT: Localization admin info panel.
• FIXED: Integration of woocommerce-tm-extra-product; PHP warnings; YITH Wishlist compatibility with UX Builder.

3.16.5 (13.01.23)

• NEW: WooCommerce 7.3 compatibility.
• FIXED: Cart count added to the shop icon globally in some cases.

3.16.4 (20.12.22)

• NEW: WooCommerce 7.2.1 compatibility.

3.16.3 (14.12.22)

• NEW: WooCommerce 7.2 compatibility.
• ENHANCEMENT: Improved WPML configuration.
• FIXED: Various accessibility and layout issues.

3.16.2 (04.11.22)

• NEW: WooCommerce 7.0.1 compatibility.
• FIXED: Copy as Shortcode on Safari; widget display and login lightbox fixes.
• UPDATED: Language files.

3.16.1 (28.09.22)

• FIXED: Various navbar and header issues; mobile logo positioning; RTL tweaks; WordPress 6.2 deprecations.

3.16.0 (15.09.22)

• NEW: WooCommerce 6.9 compatibility.
• NEW: Product additional variation images; gallery grid layouts.
• NEW: UX Builder: Copy as shortcode; display all registered image sizes; responsive column width.
• NEW: Google Fonts locally served; option to serve from CDN; color and UI improvements; SEO-friendly enhancements.
• ENHANCEMENT: Improved accessibility, performance, and cache handling.
• FIXED: Numerous UI and builder issues; sticky add to cart, gallery, and navigation tweaks.

3.16.0 to 3.16.8 notes

These updates bring compatibility with newer WooCommerce versions, improvements to the UX Builder, and broader support for accessibility and performance optimizations.

3.15.7 (14.07.22)

• FIXED: Slider dragging & scrolling on iOS 15+.
• FIXED: Lazy load not working properly on Safari.

3.15.6 (14.06.22)

• FIXED: WordPress 6.0 CSS conflict.
• FIXED: Element style not applying when column sticky.

3.15.5 (02.05.22)

• FIXED: Integration options shown in Updates tab; backup options inflating wp_options; color palette issues.
• ENHANCEMENT: PNG support for lightbox images; improved toggle accessibility.

3.15.4 (15.03.22)

• NEW: Release channel option (stable/beta).
• FIXED: Form login text string changes; color and swatch alignment fixes.
• ENHANCEMENT: Vertical Menu dropdown responsiveness.

3.15.3 (15.01.22)

• NEW: WooCommerce 6.1 compatibility.
• ENHANCEMENT: Auto height for custom-sized vertical menu dropdowns.
• FIXED: Galleries, video, and image behavior; product and swatch fixes.

3.15.2 (21.12.21)

• FIXED: Script file naming compatibility; Yoast integration; slider parallax; page loader logo size.
• ENHANCEMENT: Improved WP Rocket compatibility.

3.15.1 (17.12.21)

• FIXED: Banner responsive values; logo URL; lightbox auto open; lightbox gallery.
• ENHANCEMENT: Prevent hotspot opening quick view in builder.

3.15 (16.12.21)

• NEW: Core JavaScript file is now only 56kb (16kb gzipped).
• NEW: WooCommerce 6.0 compatibility; header vertical menu; shape dividers; performance improvements.
• ENHANCEMENT: Accessibility and responsive improvements; improved product and AJAX behavior.
• FIXED: Builder: render inline content; several builder and compatibility fixes.

3.15.x notes

These releases emphasize performance optimization, build enhancements, and new UI components, along with broader WooCommerce compatibility and accessibility improvements.

3.14.3 (07.09.21)

• NEW: HTML element in UX Builder.
• FIXED: Builder: Render paragraphs correctly for classic editor content.
• FIXED: Thank you page content option didn't render shortcodes.
• FIXED: Scroll to on mobile navigated incorrectly in some cases.
• FIXED: Infinite scroll on masonry catalog layout.
• ENHANCEMENT: Improved swatch compatibility for multiple WooCommerce extension plugins.
• ENHANCEMENT: Builder: Check post existence before editing mode.
• REVERT: Builder no longer wraps text element content with paragraphs; use HTML element for raw content.

3.14.2 (22.07.21)

• FIXED: Product categories element displayed subcategories; PHP notices addressed; mobile/draft issues resolved.

3.14.1 (14.07.21)

• FIXED: PHP issues; improved swatch and image display; RTL improvements.
• ENHANCEMENT: Improved swatch caching.

3.14.0 (13.07.21)

• NEW: Product variation swatches; UX Themes license manager; WordPress 5.8 compatibility; WooCommerce 5.5 compatibility.
• NEW: Live search latency option; automatic New badge for products newer than x days; various swatches enhancements.
• ENHANCEMENT: Builder: Sticky column option; improved CSS and performance.
• FIXED: Numerous builder issues; gallery, slider, and header fixes.

3.14.x notes

These updates introduce variation swatches, license management, and broader WordPress/WooCommerce compatibility, with a focus on builder enhancements and performance improvements.

3.13.3 (30.03.21)

• FIXED: ContactForm7 progress spinner.
• FIXED: Team Members: Follow icons display by default.
• FIXED: Page Header: Background color for featured and normal style.
• FIXED: Live search results when both live search and WC are deactivated.

3.13.2 (25.02.21)

• NEW: Option to disable sale badge in catalog mode.
• NEW: Slovenian translation added.
• FIXED: Builder: Post multi-select sorting; Gutenberg HTML blocks in WP editor; image placeholder behavior.

3.13.1 (XX.XX.XX)

• FIXED: Shared UI and builder issues; compatibility improvements for WP 5.8 era.

3.13.x notes

3.13.x marks ongoing improvements for builder compatibility, social sharing enhancements, and better integration with popular plugins, along with stability fixes and translation updates.