---
title: "Updating Your Widget Version"
slug: "updating-your-widget-version"
tags: ["Adobe Commerce (Magento)", "BigCommerce", "Custom", "Reviews ", "Shopify", "Shopify Plus", "WooCommerce"]
updated: 2025-12-01T08:26:38Z
published: 2025-12-01T08:26:38Z
canonical: "support.yotpo.com/updating-your-widget-version"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.yotpo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Updating Your Widget Version

Products

  

Reviews

###### Supported plans

Premium, Enterprise

###### eCommerce Platform

Shopify, Shopify Plus, Adobe Commerce (Magento), BigCommerce, WooCommerce, Custom

## Goals and Outcomes

Updated widget versions include bug fixes and security enhancements that improve your on-site experience and security. Additionally, the updated version may also include new features or improvements that enhance widget performance and responsiveness. Updating to the latest version ensures your widgets perform efficiently and deliver the best possible shopper experience.

In this article, you’ll learn how to manage, preview, and publish the newest available widget version.

> **Available for**
> 
> Merchants using [Yotpo Reviews 3.0 Widgets](https://support.yotpo.com/en/article/widgets-30-overview).

## How it works

When you update a widget, you replace the existing core widget code with the newest version.

If a widget includes custom CSS, those overrides remain intact. Yotpo does **not** automatically update widgets that have custom CSS applied. In this case, the widget version can only be [updated manually](/v1/docs/updating-your-widget-version#manually-updating-the-widget-version).

![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/updating-your-widget-version-image-ala214z9.png?sv=2026-02-06&spr=https&st=2026-10-31T20%3A03%3A06Z&se=2026-10-31T21%3A03%3A06Z&sr=c&sp=r&sig=K9SeZ1mIKNDLK%2F4NfsnbsWuCOyI7VqlwT0Xws6Ctzzo%3D)

### Automatic Version Updates

**By default**, Yotpo automatically updates your 3.0 widgets to the latest version. If your widget was updated, you’ll see a notification the next time you log in to Yotpo Reviews.

If you wish to **disable** the automatic update for your widget version:

1. In the Yotpo Reviews main menu, go to [**On-site Widgets**](https://reviews.yotpo.com/#/display-reviews/on-site-widgets).
2. Click on **Widget Settings** in the top right corner.
3. Turn off the **Auto-update widgets** toggle.
4. Click **Save**.

From now on, the widget version can **only** be updated manually after you preview it.

> [!CAUTION]
> **Important**
> 
> Once the widget version has been published and pushed to the live site, whether automatically or manually, it cannot be reverted.

### Manual Version Updates

If automatic updates are **turned off**, you’ll see a banner in the widget editor notifying you that a new version is **available**.

![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/updating-your-widget-version-image-fifvsn91.png?sv=2026-02-06&spr=https&st=2026-10-31T20%3A03%3A06Z&se=2026-10-31T21%3A03%3A06Z&sr=c&sp=r&sig=K9SeZ1mIKNDLK%2F4NfsnbsWuCOyI7VqlwT0Xws6Ctzzo%3D)

You can preview the latest widget version or skip the update.

> [!WARNING]
> **Tip**
> 
> When a new version is available, you can see your current widget version at the bottom of the widget editor page.
> 
> ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/updating-your-widget-version-image-xubxttc5.png?sv=2026-02-06&spr=https&st=2026-10-31T20%3A03%3A06Z&se=2026-10-31T21%3A03%3A06Z&sr=c&sp=r&sig=K9SeZ1mIKNDLK%2F4NfsnbsWuCOyI7VqlwT0Xws6Ctzzo%3D)

### Preview Version Update

Click **Preview version** in the banner to see how the latest version affects your widget’s design.

> [!CAUTION]
> **Note**
> 
> Previewing the update does not affect your live on-site experience.

You will now be able to see the latest available widget version and how it affects your widget design and settings..

- If you approve of the changes and want to push them onto your live site, click the **Update version** option in the banner.
- If you do not want to change your widget version after looking at the preview, click the **Exit preview** option and then **Skip the version**.

### Skip Version Update

If you click **Skip the version,** the banner will not appear again until a newer version becomes available.

## Related

- [Widget CSS Editor (Legacy)](/widget-css-editor.md)