Magento 2 Order Attributes

Collect any detail at checkout

Create as many custom order fields as your store needs and place them exactly where they belong in the checkout flow. Each field can be required or optional, pre-filled with a default value, and validated so you collect clean, usable data. Because attributes are collected with the order, the information travels with it through fulfillment instead of getting lost in a notes box.

14 input types for every kind of data

Order Attributes covers a full range of input types: text field, text area, date, date and time, time, yes or no, dropdown, checkbox group or multi-select, radio buttons, single-select with image, multiple-select with image, media image upload, single file attachment, rich content, and a display-only static CMS block. Option-based fields support per-option image or color swatches, and file and image uploads are validated by extension and size and stored securely.

Show the right fields at the right time

Fields do not have to appear for every order. Display conditions let you show an attribute only when the cart matches a rule, a specific shipping or payment method is selected, or the customer is shipping to certain countries, and all conditions are combined so a field appears only when every rule passes. Parent and child dependencies let one field appear based on another field's selection, with multi-level chains and automatic cycle detection, so complex forms stay clean.

Custom checkout steps

Beyond the standard positions (shipping address, shipping and payment method areas, and order summary), you can add your own custom checkout steps with a name, icon, and conditions, then place attributes inside them. This lets you group related questions into their own step in the checkout progress, rather than crowding the address or payment sections.

Everywhere an order lives

Collected values show up across the entire order lifecycle. Add them as sortable, filterable columns in the Orders grid, view and edit them on the order page with changes logged to order history, include them on invoices, shipments, and credit memos, print them on PDF documents and HTML print-outs, insert them into transactional emails, and show them on the customer's account order view. Admins can also collect attributes when creating orders from the admin.

Built for developers and integrations

Order Attributes ships with a REST API and GraphQL support for reading attribute metadata, saving values on a cart, uploading files, and reading values back. Values are also exposed as order extension attributes on standard order endpoints, so your ERP, OMS, and other integrations receive the extra order data without custom work. It runs on native Magento checkout and is store-view aware, so labels, tooltips, and options can differ per store.

Features of Order Attributes for Magento 2

• Unlimited custom fields: add as many order-level attributes as your store needs.

• 14 input types: text, date and time, dropdowns, radios, image and file uploads, rich content, and static blocks.

• Required and validated: set required fields, min and max length, format validation, and date ranges.

• Flexible placement: position fields across shipping, payment, order summary, or custom checkout steps.

• Display conditions: show fields by cart rules, shipping method, payment method, or country.

• Dependencies: parent and child fields with multi-level chains and cycle detection.

• Custom checkout steps: add your own steps with icons and conditions.

• Per-store labels and options: store-view labels, tooltips, and option swatches.

• Secure uploads: extension and size validation with hardened file storage.

• Save for future checkout: pre-fill returning customers' previous values.

• Newsletter opt-in field: subscribe customers to the newsletter from a checkout field.

• Full admin coverage: Orders grid columns, order view and edit, invoices, shipments, and credit memos.

• Emails and PDFs: attribute variables in emails and values printed on PDF documents.

• Customer account: show selected values on the customer's order detail page.

• REST, GraphQL, and extension attributes: full API access for headless stores and integrations.

How It Works

1. Go to Sales > Order Attributes > Manage Attributes and click Add New Attribute.

2. Choose an input type, set the label, and mark the field required or optional with any validation you need.

3. Set where the field appears at checkout, and add display conditions or dependencies if it should appear only in certain cases.

4. Add per-store labels, tooltips, and options, and configure file rules for upload fields.

5. Save, then choose where the value should appear: Orders grid, order view, emails, PDFs, the customer account, and your APIs.

6. Customers fill in the fields at checkout, and the values are collected with the order and shown everywhere you enabled them.

Data Collection and Control

Every attribute is store-view and customer-group aware, so you can show a field only to the right stores and shopper groups, and required rules apply only where the field is visible. Values are persisted to the quote during checkout and copied to the order on placement, with the label snapshotted so renaming an attribute later does not rewrite the history of past orders. Fields hidden by a condition are never validated as required and never save stale values, so orders always place cleanly.

Who Needs Order Attributes for Magento 2

• Stores that need delivery instructions, gift messages, or preferred delivery dates at checkout

• B2B merchants collecting purchase order numbers, VAT or tax IDs, and company details

• Businesses that need file or image uploads with an order, such as artwork or documents

• Stores with conditional questions based on cart, shipping, payment, or country

• Teams that want the extra order data in emails, PDFs, the customer account, and their ERP or OMS