User Tools

Site Tools



For more details see the One Step Checkout for Magento 2 extension page.

Guide for One Step Checkout for Magento 2

Display all checkout steps on one page to let visitors instantly modify necessary information and complete purchases as fast as possible.

  • Place checkout steps on one page;
  • Let customers edit product options on the checkout;
  • Manage checkout fields display;
  • Use automatic geolocation detection and Google Address suggestions;
  • Enable order comments and newsletter subscription;
  • Let customers select the day and the time for order delivery;
  • Choose from 2 layout types (2-column and 3-column);
  • Customize checkout page design;
  • Add custom CMS blocks to the order success page;
  • Advanced gift wrap and gift message functionality;

Before configuration

Having troubles?

  • Try disabling the extension and check if you're getting the same result with Magento default checkout. One Step Checkout is designed to be as transparent for other checkout-related extensions as possible, it will display the data “as-is”. So if you're getting suspicious results please compare them to what you get with One Step Checkout disabled.
  • Some custom themes may have custom design for blocks displayed on checkout. If you see blocks displaying incorrectly on One Step Checkout, please try switching to Magento default theme. If it helps, that will mean that theme should be adjusted to disable custom design for checkout blocks.

General settings

To configure the extension settings, please go to Stores → Configuration Amasty Extensions → One Step Checkout.

Expand the General tab.

Enable One Step Checkout - set to Yes to activate the extension.

Allow Guest Checkout - enable this option to let your customers fill in the checkout form and create accounts right on the checkout page.

Checkout Page Title - specify a custom title for the checkout page.

Checkout Page Description - provide customers with important info, including taxes (e.g. VAT), shipping or any other payment specifics.

Include main keywords for better SEO rankings and use <html> to highlight the important points.

Allow to Edit Products in the Order Summary - choose Yes to allow customers to delete products and change their quantity on the checkout page.

Reload Shipping Methods When Coupon Code is Applied - choose Yes to update the types of available shipping methods automatically after a coupon code is added. For example, you can allow free delivery after a specific coupon code is applied.


To configure automatic location detection for your customers, expand the Geolocation tab.

Geo IP Location - enable this option if you want to detect user country automatically based on the IP address.

Google Address Suggestion - use this option to show automatic address suggestions once a customer starts typing in the address field.

Learn more about Google Autocomplete feature.

Google API Key - to enable the Address Autosuggestion option you need to specify your your API key in this field.

How to get API key?

API key is required to use Address Auto Suggest. To get API key, you need your Google account. Create Google App here.

Click on the CREATE PROJECT button and configure your app settings.

Specify your project name. The project ID will be generated automatically.

Then, please proceed to this page to create a new API key. ('Maps API' should be selected at first step). Choose the necessary project.

Go to Credentials → API key.

Copy the key and fill it in the Google API Key tab on the backend of the extension.

Geo IP Data

To use the Geo IP Location option please go to Stores → Configuration → Amasty Extensions → Geo IP Data.

Databases are required for the correct work of the module. Also you need to install php bcmath or gmp extension on your server.

You can get the databases automatically or import your own data.

Hit the Download and Import button to make the extension download the updated CSV dump file and import it into your database automatically.

To import the files from your own source, use the Import option. Path to the files should look like this (the part 'var/amasty' should be replaced with your folders’ names):

In the Import section, the Import button is grayed out by default. It will be available right after you upload the CSV files. The red error notification will switch to green success notification when the import is completed.
If you have any troubles with autosuggestions, please see our troubleshooting checklist here.

Default Values

In this tab you can specify values that will be preselected on the checkout page by default to speed up the checkout process.

The Default Values settings are optional. Therefore, you can display only those values that meet your specific requirements.

With the One Step Checkout extension you can set default values for the following fields:

  • Shipping method - choose Fixed or Table Rate method according to your website needs;
  • Payment method - specify the necessary method to be chosen by default.

You can also set the necessary default values for the Country, Region/State, Zip/Postal Code and the City. Use handy dropdown menu.

See how to specify the order and names of checkout fields here.

Block Names

To set the order for the checkout blocks and customize their names to improve the checkout flow, expand the Block Names tab.

In this section, you can easily rename and reorder the blocks according to your needs via drag and drop function.

Design Settings

To fit your website style, customize the design of your checkout page in the Design Settings tab.

Display Header and Footer - select Yes to display the header and footer blocks on the checkout page.

It may be necessary to flush your Magento Cache for the changes to take effect.

Checkout Page Layout - choose one of the following layout types: a 2-column layout and a 3-column one.

Please keep in mind that, for 3 Columns layout, third column will be displayed only if Customer's Order may require shipping (contains non-Virtual products, in most cases).

Number of Lines in a Street Address - specify the number of lines for a 'Street Address' field. The max number to specify is 4. If you use system value, 2 lines will be set by default.

Display Billing Address On - choose where to display the billing address: either on Payment Method or on Payment Page or Below Shipping Address.

Display Multiple Shipping Address In - allows to display billing address form in the customer information block below shipping address (if it differs from the shipping address).

If this option is grayed, please update your Magento to version 2.2 or newer to make this setting available.

Checkout Text Font - specify the name of a necessary font. Use Google Fonts to pick the one you need quickly.

Customize your checkout page style. With a handy color picker tool you can select colors for:

  • Heading Text;
  • Order Summary Background;
  • Checkout Background.
To select a color for a particular field click on the field and the color picker tool will appear.

Here is an example of a custom checkout page design.

CMS Custom Blocks

You can choose a CMS block, that you would like to be displayed at the top or bottom of the checkout. With this feature, you can add any additional information on the checkout page: trust seals, phone numbers, delivery conditions, etc.

To create a custom block, log in as an admin and go to Content → Blocks.

To configure the display settings for CMS block, go to CMS Custom Block in the Design Settings tab.

Success Page Custom Block - specify the ID of a custom CMS block you want to display on the checkout success page.

Top Block - select a CMS block that will be displayed above the checkout.

Bottom Block - select CMS block that will be displayed below the checkout.

Here is the example of Contact Us Info CMS Block on the Success Page:

And this is how the Top Block on the checkout page is displayed:

Place Button Design

In the Place Button Design section, choose the style for the 'Place Order' button.

Place Order Button Color - customize the color of the button with the color picker tool.

Place Order Button Position - place the button either below the order total or below the selected payment method.

When selecting 'Below the Order Total' option, beware that, besides re-positioning, Place Order button behavior may slightly change. Because of that It may impact your customers checkout experience, especially in case you use any third party payment integrations. If you experience any unexpected issues, please switch to 'Below the Selected Payment Method' option.
This is how a customized Place Order button looks like on the frontend.

Additional Options

To show extra care to your customers with order comments, newsletter subscription and other additional fields, expand the Additional Options tab.

All additional options will be displayed in the Order Summary Block on a checkout page.

Order Comment - enable the option to let customers add comments to their orders right on the checkout page.

If you want to perform a more complex configuration and need to have an advanced control over your order attributes, go to the settings page of Amasty Order Attributes module.

Discount Field - let customers apply promo codes at the checkout.

Newsletter Checkbox - display the newsletter subscription checkbox.

Newsletter is Checked by Default - set the option to Yes to make the Newsletter Subscription option ticked by default.

Let Customers Create an Account at Checkout - select No to forbid the creation of accounts on the checkout page for your guest customers.

Simplify registration process with the Social Login for Magento 2 extension.

To let your guest customers create accounts right on the checkout page, choose the After Placing an Order or While Placing an Order variant.

If you select After Placing an Order, you will also need to enable or disable the ‘Create an Account’ Checkbox is Checked by Default option.

Customers will be presented with option to check the 'Create an Account' checkbox. If checked, your customer will get an email with account activation instructions after placing the order.

If While Placing an Order is chosen, set Yes in the next field to allow the extension Automatically Log in Customers After Creating an Account at Checkout.

Show VAT Number on Storefront - set the option to Yes to show VAT number on the checkout page. No is set by default.

Enable Terms and Conditions - set to Yes if you want to display Terms and Conditions checkbox.

Terms and Conditions Checkbox Positioning - if Yes, specify the position of the checkbox: Below the selected payment method or Below the Order Total.

Before you choose the position of the Terms&Conditions, check that:
  • Your Terms&Conditions settings are enabled. (Stores > Settings > Terms and Conditions, select the condition you've created previously and change the status to Enabled).
  • Select 'Manually' in the 'Applied' field if you want to display Terms&Conditions with a checkbox. If you choose the option 'Automatically', customers could only read the conditions.

  • Your Terms&Conditions can be displayed at the checkout.(Stores > Configuration > Sales > Checkout)

This is how the additional options are displayed on the checkout page:


The extension fully supports native Magento gift functionality and shows gift wrap fee and gift message options in the Order Summary block. To configure the block, expand the Gifts tab.

Allow Gift Messages on Order Level - enable this option to let customer specify gift messages for the whole order.

Allow Gift Messages for Order Items - this option enables users to specify gift messages for each item in the cart.

Gift Wrap - enable a gift wrap option on the checkout page.

Gift Wrap Fee - specify a gift wrap fee amount. Once the Gift Wrap option is selected by a customer, its price will be automatically added to order total.

See a Gift Message popup example below.

Delivery Date

Let your clients indicate the most convenient day and time interval for the order delivery.

Enabled - set Yes to show Delivery Block to customers.

Delivery Date Field is Mandatory - set 'Yes' to make the delivery date field obligatory.

Available Days - specify days available for delivery.

Available Hours - specify time intervals available for delivery. You can list them and separate by comma.

Use Amasty Delivery Date to limit or restrict delivery for the same or next day the order was placed.

Enable Delivery Comment - set 'Yes' to display the delivery comment field right below the delivery date and time information.

Delivery Comment Default Text - here you can specify the placeholder text that will be shown as an example in the delivery comment field.

See the example of the Delivery block on the frontend.

Customers will be able to select delivery days and time intervals and also leave a delivery comment.

Manage Checkout Fields

To manage checkout fields display, go to System → Mange Checkout Fields.

On the fields management page you can:

  • Specify a custom field label (field name);
  • Set field width to fit your website style;
  • Specify which of the fields should be required;
  • Enable/disable checkout fields;
  • Reorder fields position for checkout display using drag and drop function;
  • Set fields order for checkout display.
When disabling City, Country, State/Province, Zip/Postal Code, please keep in mind that shopping cart will also be affected since those attributes are used in estimations and calculations.

To create additional fields to get more valuable info at the checkout, click Add Custom Fields. You can create up to 3 custom fields.

Employ Order Attributes and Customer Attributes modules to add order and customer attributes to your checkout fileds, you can also sort customer and order attributes alongside checkout fields and adjust each attribute settings.

Easily rename and reorder the fields according to your needs.

To collect more order-related data, try Magento 2 Custom Checkout Fields.

Checkout Analytics

To view checkout analytics insights, go to Reports → Checkout Analytics.

The extension allows to analyze customers behavior by looking at checkout fields completion rate and use this information to optimize your page.

To view the detailed statistics based on Store Views, Customers Groups and Periods, use smart filters above the chart.

There are 5 time filters available:

  • Today;
  • Last 7 days;
  • Last 30 days;
  • Overall;
  • Custom.
If you want to check the analytics for a custom period, specify the particular dates.

Below the diagram you see the data for each checkout section separately.

Frontend: Checkout Page for Registered Customers

Save personal info for registered customers for extra convenience.

If a customer has already registered in your store, his/her shipping address will be automatically saved for future checkouts

  • Customers can edit options of configurable products (color, size etc.) on the checkout page.
  • It's also possible to delete products from the cart right on the checkout page in case there are 2 or more products without leaving the page.

Frontend: Checkout Page for Guests

Let visitors create their accounts at checkout and automatically log in them after they place an order. As an alternative, you can offer your clients to create a profile after the order placing.

Frontend: Checkout Page With Additional Address

Let visitors add new billing address if it differs from shipping address.

Find out how merchants increase the Average Cart Value by featuring Cross-Sell products on Magento 2 cart and checkout pages.
Find out how to install the One Step Checkout extension for Magento 2 via Composer.

Rate the user guide
 stars  from 7 votes (Details)
magento_2/one_step_checkout.txt · Last modified: 2019/07/31 09:53 by tihomirova