# WooCommerce Migration

To use the Cash App Afterpay product with WooCommerce, update the *Afterpay Gateway for WooCommerce* extension to the latest version, minimum v3.8.7

If you are on a lower version than this, please update. See the [Update Plugin](#update-plugin) section below if you're not sure how to upgrade your plugin to the latest version.

If you are on the minimum or higher version, existing settings and configurations continue to work as before; there is no need to change them.

## Update Plugin

To update the 'Afterpay Gateway for WooCommerce' plugin, please follow the below steps.

<Note>The Cash App Afterpay plugin is called the Afterpay Gateway for WooCommerce. This doesn't affect any of the instructions or advice below.</Note>
As updates for the **Afterpay Gateway for WooCommerce** plugin are released, notifications appear in WordPress Admin.

A number appears in WordPress Admin next to the Plugins link, it shows the number of plugin updates available.

![wc-update-1.png](https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/wc-update-1.png)

<Note>
  We strongly recommend that you backup website files and data before you do an update.
</Note>

### Upgrade Instructions

1. Go to the **WordPress Admin Dashboard**.

2. Go to **Plugins** > **Installed Plugins**.

3. Find the **Afterpay Gateway for WooCommerce** in the plugin list.

   > The version update notification is displayed, with links to the release details, and to update the plugin.

4. Click the **update now** link.

   ![wc-update-2.png](https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/wc-update-2.png)

5. The **Afterpay Gateway for WooCommerce** plugin now starts to update.

   ![wc-update-3.png](https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/wc-update-3.png)

6. Once complete, the notification bar turns green and the text changes to **Updated!**.

   ![wc-update-4.png](https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/wc-update-4.png)

## Brand Assets

There are new Cash App Afterpay brand assets to use at checkout and across your site. See the [Brand Assets](/cash-app-afterpay/guides/welcome/migrate-from-afterpay-to-cash-app-afterpay/brand-assets) page in this guide for these new assets.

The table below has examples of the changes:

|         | Afterpay                                                | Cash App Afterpay                                       |
| ------- | ------------------------------------------------------- | ------------------------------------------------------- |
| Logos   | <img src="https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/ap-logo-resized.png" /> | <img src="https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/caap-white-logo-resized.png" /> |
| Buttons | <img src="https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/ap-button.png" /> | <img src="https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/caap-button.png" /> |

Any custom messaging updates must be reviewed by your Account Manager.

## Messaging

Messaging is automatically updated if you use On-Site Messaging, our current messaging product, or its predecessor that used the JavaScript library for messaging. In both cases wait for the automatic update process to occur. Monitor your email for advance notice of this automatic update.

See the table below for an example of the changes:

| Afterpay                                                | Cash App Afterpay                                       |
| ------------------------------------------------------- | ------------------------------------------------------- |
| <img src="https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/ap-mess-2.png" /> | <img src="https://files.buildwithfern.com/cash-app.docs.buildwithfern.com/2026-01-27T23:03:44.161Z/cash-afterpay/assets/images/caap-mess-1.png" /> |

The automatic Messaging update includes changes to *learn more*/lightbox asset if you use that.

If you use elements of Afterpay Messaging but not the standard Onsite Messaging Widget, then update the Afterpay elements with new Cash App Afterpay elements. See the [Brand Assets](#brand-assets) section above.

Any custom messaging updates must be reviewed by your Account Manager.

## FAQs

If you have a technical question on the migration, see our [FAQs for the Migration](/cash-app-afterpay/guides/welcome/migrate-from-afterpay-to-cash-app-afterpay/migration-fa-qs) page.