If you are upgrading from version 2.x, do not treat version 3.x as a simple visual update.

Read the full Migration from 2.x to 3.x guide before updating a production website.

Use the full guide if:

• the website already runs version 2.x
• the website has custom CSS, JavaScript, hooks, or addon integrations
• you plan to update a live shop instead of a staging copy

The guide covers rollout order, compatibility changes, staging workflow, product-type migration, and production precautions in detail.