Get 15% off Mageplaza extensions & subscriptions! Use code HIMAY at checkout.

How to Add Checkbox to Checkout in Magento 2

Vinh Jacker | 04-23-2024

The Most Popular Extension Builder for Magento 2

With a big catalog of 224+ extensions for your online store

Magento’s default configuration provides basic functionality for the checkout process, but relying only on the default setup may not collect valuable data for store owners. Forward-thinking entrepreneurs often find ways to enhance the checkout process by adding a checkbox to the checkout page. This checkbox not only allows customers to select additional options but also collects important customer information for the store owner.

In this article, we’ll explore two methods for adding a checkbox to the Magento 2 checkout page. They consist of customizing code manually or using a Magento 2 custom checkout fields extension.

Method 1: Use Code to Add Checkbox to Checkout Page

Step 1: Create the layout file

Firstly, create a new file named in the below-given path


This file depends on the Magento_Checkoutmodule to customize the checkout page.

Note: Replace VendorName and ModuleName with the actual module names in your custom module.

Step 2: Create a custom JavaScript file

Under the folder VendorName/ModuleName/view/frontend/web/js/view, create a custom JavaScript file named yourcustom.js.

Now, add the below-mentioned code:

    function (ko, Component) {
        "use strict";

        return Component.extend({
            defaults: {
                template: 'VendorName_ModuleName/yourtemplatefileName'
            isRegisterNewsletter: true

Step 3: Create the HTML template file

In the folder VendorName/ModuleName/view/frontend/web/template, create a theme extending file named yourtemplatefileName.html.

<div class="col-mp mp-12">
    <input type="checkbox" name="newsletter" data-bind="checked: isRegisterNewsletter, attr: {id: 'place-order-newsletter'}"/>
    <label data-bind="attr: {for: 'place-order-newsletter'}"><span data-bind="i18n: 'Custom checkbox'"></span></label>

Step 4: Add components to checkout page layout

Finally, add JavaScript-powered components to the checkout page layout, using an HTML file as a template, located at


<page xmlns:xsi="" layout="1column" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
        <referenceBlock name="checkout.root">
                    <argument name="jsLayout" xsi:type="array">
                        <item name="components" xsi:type="array">
                            <item name="checkout" xsi:type="array">
                                <item name="children" xsi:type="array">
                                    <item name="steps" xsi:type="array">
                                        <item name="children" xsi:type="array">
                                            <!-- Modifying an existing step-->
                                            <item name="shipping-step" xsi:type="array">
                                                <item name="children" xsi:type="array">
                                                    <item name="shippingAddress" xsi:type="array">
                                                        <item name="children" xsi:type="array">
                                                            <item name="before-form" xsi:type="array">
                                                                <item name="children" xsi:type="array">
                                                                    <item name="newsletter" xsi:type="array">
                                                                        <item name="component" xsi:type="string">VendorName_ModueName/js/view/yourcustom</item>


Method 2: Use Magento 2 Custom Checkout Fields Extension

Another way to create multiple checkboxes or additional fields within minutes is to use Magento 2 Custom Checkout Fields extension. With this extension, you can generate new fields directly from your admin panel without requiring any programming skills.

Magento 2 Custom Checkout Fields allow online owners to add and customize additional fields to the checkout pages. With this module, businesses can efficiently collect essential customer information through 14 input types, including text field, text area, date, date & time, yes/no, dropdown, multiple-select, radio/ single-select with image, checkbox/ multiple-select with image, media file attachment, content, and static block.

Input type

You have the flexibility to add custom fields and position them anywhere on your checkout pages. This allows you to create concise surveys and collect valuable customer data. From the results, you can quickly address any issues that impact your website’s shopping experience and enhance your business’s brand.

Furthermore, this module packs in extra outstanding features for store owners.

  • Collect customer information with unlimited attributes
  • Limit fields to specific customer groups and store views
  • Set attribute priority for frontend display
  • Configure fields to appear depending on others
  • Show new attributes in various positions
  • Manage custom fields easily in order grid
  • Display custom fields in PDFs and emails as needed

Custom Checkout Fields

Custom Checkout Fields for Magento 2

Collect extra customer data at the checkout page to improve marketing strategy

Check it out!

Here is the step-by-step guide to adding a checkbox to the checkout page via Magento 2 Custom Checkout Fields extension:

  1. Navigate to Mageplaza > Order Attributes > Manage Attributes

  2. Click Create New Attribute to make a new custom field

  3. Fill in the following details:


  • Default Label: Add the name of the new custom field
  • Attribute Code: Add a code for the new custom field (no spaces, max 30 symbols).
  • Input Type: Choose Checkbox/Multiple-Select With Image
  • Values Required: Decide whether the custom field is compulsory to fill in.
  • Add to Sales Order Grid: Choose whether to add the custom field to the order grid
  • Add to PDF Files: Add the custom field to PDF documents
  • Add to Confirmation Emails: Insert the custom field to confirmation emails
  1. Click Save to create the new order attribute.

In conclusion, adding a checkbox to the Magento 2 checkout page can be achieved through two methods. Apart from direct coding, we suggest using the Magento 2 Custom Checkout Fields extension from Mageplaza to enhance user experience and streamline the transaction process. By following the steps outlined above, you’ll find the best option for your website.


Hello, I'm the Chief Technology Officer of Mageplaza, and I am thrilled to share my story with you. My deep love and passion for technology have fueled my journey as a professional coder and an ultra-marathon runner. Over the past decade, I have accumulated extensive experience and honed my expertise in PHP development.

Related Post

Website Support & Maintenance Services

mageplaza services

Make sure your store is not only in good shape but also thriving with a professional team yet at an affordable price.