# Release Notes

<details>

<summary><strong>How to check your theme version</strong></summary>

To check your Soul version, click on the three-dot icon at the top of the Theme Editor to view the theme actions, including the version number.

![](https://1485471486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7H1ZB4J9TQlWDiI82pRW%2Fuploads%2FZd0KCtjlSzLUdpJ7n6Zc%2Fimage.png?alt=media\&token=c07eaa58-eace-4af3-903c-f2832bc46e97)

</details>

## <mark style="color:blue;">**Version 5.1.0 - December 03**</mark><mark style="color:blue;">**, 2025**</mark>

This release focuses on new feature additions and overall code improvements to ensure a smoother and more consistent experience across browsers. Below is the full changelog for this version.

### Added

* Added a new “Age verification popup” to help merchants comply with content age restrictions.

### Fixes and improvements

* Improved CSS code for better compatibility across different browsers.
* Fixed an issue where unsupported html code caused text display errors on certain pages.

## <mark style="color:blue;">**Version 5.0.1 - August 08, 2025**</mark>

This release improves responsive layout behavior on iOS devices.

### Fixes and improvements

* Fixed an issue where certain iOS browsers displayed layout inconsistencies. Adjusted code to improve compatibility and ensure responsive performance.

## <mark style="color:blue;">**Version 5.0.0 - July 23, 2025**</mark>

Soul 5.0.0 introduces Boule — a clean and modern preset crafted for nutrition, wellness, and natural food brands. Inspired by earthy tones and wholesome simplicity, this preset features a deep crimson red paired with a light cream background to convey both vitality and softness. Boule is ideal for brands looking to communicate trust, health, and warmth in their visual identity.

### Added

* Added new demo - <mark style="background-color:red;">**Boule**</mark>
* Added a new “**Product list: Tab**” section using Theme Blocks.
* Added a new “**Scroll reveal banner**” section using Theme Blocks.
* Added a new **Pre-order** feature.
* Added a new **Back-in-stock alert** feature.
* Added a “Horizontal arrow” option to the Primary button style setting under the Buttons section in Theme settings.
* Added a new “Blurred reflection” setting to the Header section.
* Added a “Color” setting to the Caption block in the Rich text section.
* Added a new “Background media” setting to the Flex section.
* Added a new “Reveal text” block to the Flex section.
* Added a “Color” setting to the Text block in the Flex section.
* Added a new “Item with large image” block to the Running text with image section.

### Changed

* Renamed the “Item” block to “Item with small image” in the Running text with image section for clarity.

## <mark style="color:blue;">**Version 4.0.0 - June 23, 2025**</mark>

This is a major structural update of the Soul theme, with its architecture refactored to follow the latest Shopify theme standards.

### Changed <a href="#added" id="added"></a>

* The matching demo preset is automatically applied when merchants install the theme from a specific listing, ensuring a fast, seamless setup that perfectly mirrors the demo store.

## <mark style="color:blue;">**Version 3.1.0 - May 13, 2025**</mark>

Soul 3.1.0 focuses on refining the Elegant preset with updated visual design and improved defaults. This version also introduces new controls for theme color opacity and enhances key features for a smoother shopping experience.

### Added <a href="#added" id="added"></a>

* Added a new "Slide with large bottom text" block to the Slideshow section.
* Added auto-play product videos on hover in product cards – if a video is placed as the second media item in the product gallery, it will automatically play when hovering over the product image.

### Fixes and Other Improvements <a href="#added" id="added"></a>

* Introduced new opacity controls for theme colors.
* Updated default settings and adjusted several design elements of the Elegant preset for a more polished look.

## <mark style="color:blue;">**Version 3.0.0 - April 10, 2025**</mark>

Soul 3.0.0 update, we've focused on enhancing the visual design to deliver a more refined and engaging shopping experience.

### Added <a href="#added" id="added"></a>

* Added new demo -  <mark style="background-color:orange;">**Elegant**</mark>**&#x20;**&#x20;
* Added a new "Flexible content" section using Theme Blocks.
* Added a new "Collection spotlight grid" section.
* Added a new "Testimonials" section.
* Added a new "Image with product" section.
* Added a new "Dynamic hover blocks" section.
* Added a new "Swatch filter" feature.
* Added a new setting "Cart icon" under Cart section in Theme settings.
* Added "Extra small" option to Price size setting under Product cards section in Theme settings.
* Added a new setting "Corner radius" under Blog cards section in Theme settings.
* Added a new setting "Use icons" to Header section.
* Added a new setting "Background overlay opacity" under the "Transparent header" settings group of the Header section.
* Added a new setting "Image corner radius" to the Image with text section.
* Added a new setting "Show separator line" to the Multicolumn section.
* Added "Extra small" option to Text size setting of Caption block in Rich text section.
* Added "Block spacing" setting to Caption block in Rich text section.
* Added "Extra large" option to Banner height setting of Image banner section.
* Added new "Heading size" and "Text size" settings to the Column settings group in the Multicolumn section.
* Added a new setting "Content position" to Footer section.
* Added a new setting "Alignment" to Menu settings group in Footer section.
* Added a new setting "Heading style" to Blog posts section.
* Added a new setting "Color scheme" to Post details block in Blog post section.

### Fixes and Other Improvements

* Renamed the theme style "Default" to "Dark".
* Set the ‘Elegant’ preset as the new default theme style.
* Running text effect on "Announcement bar" section now shows when more than one block is added.

### Demo store <a href="#fixes" id="fixes"></a>

* View the new  <mark style="background-color:orange;">**Elegant**</mark>**&#x20;** → [**Demo store**](https://soul-theme-elegant.myshopify.com/)

## <mark style="color:blue;">**Version 2.0.0 - February 05, 2025**</mark>

Soul 2.0.0 update, we've focused on enhancing the visual design to deliver a more refined and engaging shopping experience.

### Added <a href="#added" id="added"></a>

* Added new demo -  <mark style="background-color:orange;">**Warm**</mark>&#x20;
* Added a new "Collection showcase" section
* Added a new "Image gallery" section
* Added a new "Image comparison" section
* Added a new "Text pair" block to the Rich text section.
* Added a new "Banner with text on image" block to the Product grid section on the collection page.
* Added a new setting "Desktop image width" for the Lookbook section.
* Added a new setting "Block spacing" to the blocks in Image with text section.
* Added a new setting "Text font weight" for the Running text with image section.
* Added a new setting "Color scheme" in the Login section on Customer login page.
* Added a new "Sticky cart" block feature to the Product information section on the product page.
* Added Mega menu heading font settings under Typography section in Theme settings.
* Added Border settings under Badges section in Theme settings.
* Added Navigation arrows style settings under Layout section in Theme settings.
* Added Text font weight, Primary button and Secondary button style settings under Button section in Theme settings.
* Added Title size, Title font weight, Price size, and Quick add button radius settings under Product card section in Theme settings.

### Changed <a href="#fixes" id="fixes"></a>

* The "Banner" block name in the Product Grid section on the collection page has been updated to "Banner with text below".

### Demo store <a href="#fixes" id="fixes"></a>

* View the new  <mark style="background-color:orange;">**Warm**</mark>**&#x20;** → [**Demo store**](https://soul-theme-warm.myshopify.com/)

## <mark style="color:blue;">**Version 1.2.0 - December 20, 2024**</mark>

Soul 1.2.0 update, we've focused on enhancing the visual design to deliver a more refined and engaging shopping experience.

### Added

* Added an **outline gradient** to the primary and secondary buttons in the color scheme settings.
* Added an **icon color gradient** in the color scheme settings.
* Added a **color heading** to the main page in the color scheme settings.
* Added **navigation heading** **font** settings under typography settings.
* Added **style** setting for the badges.
* Added **text alignment** setting for the breadcrumb.

### Fixes

* Fixed layout error where the Popup notification cart style caused the top corner to be cut off when scrolling down in the cart settings.
* Fixed an issue where the sort feature on mobile did not update the option name after each selection.

## <mark style="color:blue;">**Version 1.1.0 - October 10, 2024**</mark>

Soul 1.1.0 introduces several fixes and new features

### Added

* Added **Back to top** feature.
* Added a **Countdown timer** block to the Product Information section on the product page.

### Fixes

* Error when hiding the Quantity block of the Product Information section on the product page.
* When clicking the Quick Add button on the lookbook popup in mobile view, the Quick Add popup appears underneath the Lookbook popup.
* Unable to change the color of the blog date, blog author, blog breadcrumb, and back icon in the mobile menu.

## <mark style="color:blue;">**Version 1.0.0 - September 10, 2024**</mark>

Initial release 🎉&#x20;

The Soul release log records the date and details of each Soul release. Use this document to keep track of new versions and features. We highly recommend keeping your theme version updated to the latest version for the best performance and newest features.
