Skip to content

Field Types

Date Field

Date field with a date picker for event dates, delivery scheduling, or personalised date engravings.

When to use

  • Event or occasion date
  • Preferred delivery / pickup date
  • Date to engrave on a product
Delivery date field with the date picker open on the Personalized Gift Box demo product

The delivery-date field on the Personalized Gift Box demo product — captured on the live Smart Add-Ons demo store.

Settings reference

SettingDescription
Field labelThe title customers see above the date picker.
PlaceholderHint text shown in the empty field.
Earliest date / Latest dateOptional limits on which dates can be chosen. Leave empty for no limit.
DescriptionOptional help text shown below the field label on the product page.
Required fieldCustomers must choose a date before adding the product to cart.
Price typeFixed amount, Percentage of product price, or Formula (Pro plans). The price is applied when a date is chosen. See Pricing.
Quantity pricingPer product quantity multiplies the price by the quantity ordered. Flat fee (once per line item) charges it once.
Min / Max product qtyApply the add-on price only when the product quantity is in this range. Leave the maximum empty for no limit.
Conditional logicTick Enable conditional logic to show or hide this field based on another field in the same group. See Conditional logic.

Order item meta

The selected date is stored on the order item:

order-meta.txt
Field label: "Event date"
Value: August 15, 2026
Price: +0.00

How to add a date field

  1. In WordPress, go to Smart Add-Ons → Add-On Groups and open a group, or click + Add group.
  2. Click + Add field.
  3. Enter a Field label and set Field type to Date.
  4. Under Date settings, set an Earliest date and Latest date if only some dates are allowed.
  5. Leave the price at 0, or enter a Fixed price if choosing a date is a paid service.
  6. Click Save group, then open a product the group applies to and check the field.

Example: delivery date for a cake order

A bakery adds a date field labelled “Pickup date”, ticks Required field and sets the Earliest date to the first day orders can be ready. Customers pick a date from the calendar; a date outside the allowed range is rejected with a clear message. The cart and order show the date in your site’s date format, for example “Pickup date: August 15, 2026”.

Date field FAQ

Can I block weekends or specific days?

Not in version 1.0. You can set an earliest and a latest date. Blocking individual days is not available yet.

Are the earliest and latest dates fixed or relative to today?

They are fixed calendar dates that you enter. If your lead time moves, update the Earliest date.

Which date format is used?

The picker follows the customer’s browser. In the cart, emails and order screen, the date uses the format set in WordPress under Settings → General.