Knowledge base
Video tutorials
Try searching for:
Recently viewed articles:

Table of contents

Creating custom fields at checkout

Custom fields allow you to collect extra data like country-specific tax IDs, notes on how to fulfill orders, or any other information from your customers at checkout. You can add as many custom fields as you want to the standard Ecwid one-page checkout.

The information that your customers submit via custom checkout fields will appear in the order details and in admin order notifications. It can also appear in invoices and/or in your store’s customer notifications if you wish. You can make filling out the fields mandatory or voluntary for your customers.

Custom checkout fields let you collect information for the whole order. To gather information for individual items, like custom sizing, use product options instead.

Available field types

You can add the following custom field types to checkout:

  • Text fields (single-line or paragraph)
  • Radio buttons
  • Dropdowns
  • Date pickers
  • Selection buttons
  • Checkboxes

It’s up to you to choose which field type best suits the data that you want to collect. For example, you can use date and time pickers for calendars, text fields for delivery instructions or gift messages, and selection buttons for customer feedback surveys.


Example of a custom single-line text field

Adding custom fields to checkout

One-page checkout in Ecwid includes entering email address, shipping address, and pickup details, as well as choosing shipping methods, pickup methods, and payment options. You can add an unlimited amount of custom fields to any of the checkout steps except for the final “Thank you for your order” page.

To add a custom field to checkout:

  1. From your Ecwid admin, go to Settings → Custom Checkout Fields.
  2. On the opened page, click + Add Field.
  3. Select the custom field type. Preview appears on the right:


  4. Click Next Step.
  5. Name the field to let customers know what it is about (e.g., “Your dimensions”) and add other field content according to its type. For fields with options, you can mark the option that will be selected by default as well as add surcharges. For example, you can charge different amounts of extra money for different types of packaging.
  6. Click Next Step.
  7. From the Select checkout step for field display dropdown, choose the checkout step where you want this custom field to appear.
  8. Enable the Required field toggle if you want customers to fill out the field/choose an option before they can proceed with checkout.
  9. Click Limit field display at checkout if you want to make this field available only to part of your customers. Limitations are available based on country, shipping method, or payment method.
  10. Click Set up field display after order placement to change where the field data is displayed in the order details and enable the Show field in invoices and/or Show field in customer emails toggles if you want.
  11. Click Create and Display at Checkout to publish the field, or click Create Without Display to finish creating the field without making it available for customers at checkout. You can enable or disable fields later.

That’s it! You’ve added a custom field to your store.

Adding surcharges to custom field options

With surcharges, you can increase or decrease order price as customers check out in your store. For example, you want to offer gift wrapping for the whole order, and there are two types of paper available. One is regular craft paper (costs $5), and the other is hand painted (costs $10). You can offer these two options to your customers at checkout.

To add surcharges to custom field values:

  1. Go to Settings → Custom Checkout Fields.
  2. Click Actions → Edit for a field that you want to adjust or create a new field.
  3. In the Content and surcharge block, click Add surcharge next to the field option.
    Available for radio buttons, checkboxes, dropdowns, and selection buttons field types.
  4. Enter the surcharge amount. It can be a positive or negative value.
  5. From the Option chosen automatically dropdown at the bottom of the block, choose your option. You can make one of the values preselected, or you can go with None.
  6. In the Display at checkout block, enable the Required field toggle if you want customers to be required to choose an option before they can proceed with checkout.
  7. Save the changes.

That's it! You’ve added a surcharge to your custom field options, and the surcharge value will be added to (or subtracted from) the order price at checkout if customers go for one of the options.

Here’s how surcharges can look to customers. The order price changes immediately when they select an option:


Editing custom fields

After you add a custom field to checkout in your store, you can change its content and settings however you like. For example, if later you want to edit a field's name or make it available only to customers from specific countries. You can adjust any part of your field except for its type.

When editing custom fields, you can also add translations to them if your store has multiple languages.

To edit custom fields:

  1. Go to Settings → Custom Checkout Fields.
  2. Click Actions → Edit for a field that you want to adjust.
  3. Edit field content and settings.
  4. Click Save.

That’s it! Now the updated field will appear at checkout.

Enabling, disabling, and deleting custom fields

You can enable, disable, or permanently delete custom fields that you have in your store. If you disable a field, it will no longer be displayed at checkout. You can enable the field back when you need it.

To manage custom fields:

  1. Go to Settings → Custom Checkout Fields. On the opened page, you will see a list of custom fields that you’ve created.
  2. To enable or disable a specific field at checkout, switch the toggle next to it:


  3. To delete the field completely, click Actions → Delete → Yes.

Sorting custom fields

If you add more than one custom field to any of the checkout steps, you can change the order in which the fields appear at this step. Sorting the fields helps position them in a way that best suits your needs. For example, you can place mandatory fields first.

To sort custom fields:

  1. Go to Settings → Custom Checkout Fields.
  2. Click Actions → Sort for any of the fields. On the opened page, you will see a list of all the custom fields that exist in your store grouped according to their checkout step.
  3. Drag and drop the fields so that they appear in the order you need:


Changes are saved automatically.

The custom field order that you set will also be used in the order details as well as in your store's notifications and invoices (if you chose to show the fields there).

Accessing custom field data

You can always access the data that customers submit via custom checkout fields in the order details in your store admin. Custom field data can appear in the payment details block of the order details, as well as in the order comments, customer details, or shipping/pickup blocks, depending on the option you choose when creating the field.

Field data is also available in the admin email notifications, plus in customer email notifications and/or in the order invoices if you enable these options for a particular field.

To access custom field data in the order details:

  1. From your Ecwid admin, go to My Sales → Orders.
  2. Click on the order to open it.
  3. Find field data in the corresponding order details block:


Also, you can download custom field data stored for your orders as a CSV file. Learn more about exporting orders

Was this article helpful?

Awesome! Thanks for your feedback!

Thanks for your feedback!

Sorry about that! What went wrong?
4 out of 4 found this helpful
We use cookies and similar technologies to remember your preferences, measure effectiveness of our campaigns, and analyze depersonalized data to improve performance of our site. By choosing «Accept», you consent to the use of cookies.
Accept cookies Decline