How to rename steps in 2-step checkout
Introduction
This guide was created to help you resolve an issue that may arise after updating to Venta Theme v1.5.2 or higher, where you're no longer able to customize the step titles. If you're trying to rename steps like "Shipping" or "Payment" and your changes are not reflected, follow the instructions below to override the titles correctly.
Checkout Steps Configuration
To override step titles, you need to create a configuration XML file and define your custom labels.
1. Create the Configuration File
In your project directory, navigate to:
app/design/frontend/Magebit/<Project_Theme>/etc/
Inside this directory, create a file called: hyva_checkout.xml
2. Define Custom Step Labels
Paste the following content into hyva_checkout.xml. Replace your_checkout_name with the actual name of your custom checkout.
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:module:Hyva_Checkout:etc/hyva_checkout.xsd">
<checkout name="your_checkout_name" parent="venta_default">
<step name="login" label="Your Custom Login Label" />
<step name="shipping" label="Your Custom Shipping Label" />
<step name="payment" label="Your Custom Payment Label" />
</checkout>
</config>
You can modify only the steps you need to change — there's no requirement to override all of them.
3. Clear Magento Cache
After saving the file, clear Magento’s cache:
d/magento cache:clean
d/magento cache:flush
4. Verify the Result
Open the checkout page on the storefront — you should now see your custom step titles instead of the defaults.
Additional information
If you're experiencing an issue where the Login step is still shown even though Allow Guest Checkout is enabled, or if the Shipping and Payment steps have incorrect numbering — and you don’t plan to use the login step at all — you can remove it by adding the following line to your hyva_checkout.xml configuration:
<step name="login" remove="true" />
This will completely hide the login step from the checkout flow, helping streamline the user experience when guest checkout is not in use.