Some of our services appear not to be working at the moment.

Our team has been notified, and is working on sorting out the issue.

Order Attributes


When shop owners understand more about customers, it's easy to increase sales and handle fast for their stores. Mageplaza Order Attributes extension allows admins to add custom fields to the checkout page. It helps the store owner to easily collect more information and increase customer satisfaction. This module provides a variety of custom fields such as Text Field, Text Area, Date, Yes/No, Dropdown, Single-select With Image, Multiple Select with Image, Single File Attachment, Content. Order Attributes will be managed easily on the grid order. Admins can also restrict them to customers group or store views.

Order Attributes is also displayed when admins creates the order in the backend.

Download and Install

- Download Mageplaza Order Attributes
- Installation Mageplaza extension

How to configure

From the Admin Panel, go to Sales > Order Attributes

1. Configuration

From the Admin Panel, go to Sales > Order Attributes > Configuration

- Enable: Choose Yes to use this module

2. Manage Attributes

2.1. Grid

- This is a place to store all created Order Attributes
- From the Grid, admins can capture the basic information of Attribute such as: Default Label, Attribute Code, Type, Required, Position, Store View, Customer Group, Sort Order, Create At, Updated At and Action.
- To delete the Attribute, admins need to edit the attribute and click Delete
- In addition, admins can Filter, Change Store View, hide/show the Columns

2.2. Add New Attribute
2.2.1. Properties

- Default Label: The default display name for Attributes in the Grid and Frontend
- Attribute Code:
- Enter the Attribute code. Admins can use Attribute code to add some templates such as Order, Email, ...
- Make sure you do not use spaces or more than 30 symbols.
- If leaving this field, it is based on the Default Label field.

- Input Type: Select input/select data type. There are 11 input types that admins can choose:

- Text: The input type is a text line (not downstream).

- Text Area: The input type is a text. Customers can enter multiple lines of text in this field

- Date: This field has the format as Date. When accessing the checkout page, the field is assumed to be the current date.

- Yes/No: The field only includes 2 options as Yes or No.

- Dropdown: The field has the format as Dropdown. Customers are only selected one of the options that admin has set in the backend

- Multi-Select: The field has the format as Multiple-Select. Customers can choose one or more options that admins have set in the backend

- Single-select with image: Customers only choose one of the Images/Colors that admins have set

- Multiple-select with image: Customers can choose one of the Images/Colors that admins have set

- Media Image: Customers can upload the image file (only include the image file, not docs file or PDF files, etc) that they want
- Single File Attachment: Customers can upload the attachment that they want
- Content: Customers can insert the image and enter the text as well as edit them with ease.

- Default Value:
- Only display with the Input Type as Text Field, Text Area, Date, Yes/No, Content
- This value will be displayed as the value of the field if the attribute is displayed in the Frontend

- Values Required:
- Select Yes to force the users to enter a value for the field
- Not displayed with Input Type = Media Image and Single File Attachment

- Input Validation:
- Only show when Input Type = Text Field
- Stipulate the values that are accepted in this field, which is one of the following values:

- Input/Output Filter:
- Show when Input Type = text field, text area
- It has the benefit as aiming to the HTML values that customers can enter the field
- There're 3 options:
- None: Ignore the check HTML, allow HTML tag that can work

For example: test <p>HTML</p> is transformed into:

- Strip HTML Tags: Remove the HTML tags that include in the field

For example: test <p>HTML</p> is transformed into:

- Escape HTML Entities: Encode the HTML tags that include in the field

For example: test <p>HTML</p> is transformed into:

- Add to Sales Order Grid: Choose Yes so that the attribute is displayed in the grid at Sale > Orders
- Add to PDF Files:
- Show the compatiblity with Mageplaza PDF Invoice extensions (only apply for PDF Order)
- You can refer the guide here

- Add to Confirmation Emails:
- Show to insert Order Attribute to the email confirm order
- You can refer the guide here

2.2.2. Frontend Properties

- Position: We support 7 positions that can display Order Attribute:

- None: Order Attribute doesn't show on the Frontend and in the Backend
- Shipping Address
- Shipping Method Top
- Shipping Method Bottom
- Payment Method Top
- Payment Method Bottom
- Order Summary

- Use Tooltip:

- Select Yes to display the Tooltip instructing the customers enter a value in the Field
- Admins need to enter the Tooltip in the Manage Labels/Options so that the tooltip is displayed on the Frontend

- Store View: The attribute is only displayed in the selected Store View
- Customer Group: The attribute is only displayed to the Customer in the selected group
- Add to Sales Order View: Select Yes to display the Attribute at the Order of the Customer. Customers can check the content of the attribute that was filled after placing order.

- Sort Order:
- Set the display order of the Attribute
- 0 is the highest position
- Admins need to pay attention when placing this dependency on another Attribute. It is possible that the attribute child will be displayed on the Attribute parent

2.2.3. Manage Labels/Options

- Manage Labels:
- Set the display name outside the frontend for the Attribute in each store view
- If leaving this field blank, the Default Label is populated in the Properties tab

- Manage Tooltips:
- Set up short instructional content of Attribute for Customer in each store
- mIf left blank, the tooltip is not displayed on the Frontend

- Manage Options:
- Only display with Input Type = Dropdown, Multiple Select, Single-select with Image, Multiple-select with Image
- Admin can add options for Attribute in each store view for Customer to choose
- Image is only displayed with Input Type = Single-select with Image, Multiple-select with Image. Admin can choose color or upload image for option

2.2.4. Depend Attributes

- Select an attribute with drop type, Single-select with Image to parent field. Parent Field options are automatically loaded into Depend on options
- Attribute editing is only displayed when Customer selects the option selected in Depend on options. Admin can install depend on many options
- In addition, Attribute can also depend on one or more shipping methods
- When the Attribute has been added to another Attribute, just depend on the Shipping method, make sure the 2 dependents are selected so that the attribute is displayed.

1. Checkout page Magento

2. Mageplaza One Step Checkout

Was this article helpful?
Thank you!