Skip to content

Shipping ​

The Shipping element sets shipping methods and shipping fees in the form. The shipping fee is automatically included in the Total for a complete order amount calculation.

Basic ​

Label (required) ​

The label text displayed above or beside the shipping field (e.g., "Shipping Method", "Shipping Fee", "Logistics").

Unique Name (required) ​

Identifies this form element internally within the system. The name is auto-generated by default; you can also modify it manually as needed. Naming rules:

  • May only contain lowercase letters, numbers, and underscores
  • Must start with a letter

Display Mode ​

The way shipping methods are displayed. The configuration area below changes depending on the selected mode.

ModeDescriptionSuitable scenarios
SingleSingle shipping method with a fixed shipping feeOnly one shipping method (e.g., flat-rate shipping)
Dropdown SelectDropdown selection; users select a shipping method from a dropdown listMultiple shipping methods; saves space
Radio ButtonsRadio buttons; users select a shipping method from a radio listFew shipping methods; clear at a glance
Card SelectionCard selection; shipping methods appear as cardsNeed to display logistics images and detailed information

Settings under Single mode ​

When Single is selected, configure one fixed shipping method:

Price ​

The shipping fee amount (minimum 0). Set it with the +/- buttons or enter it directly in the number input field.

Free shipping

Setting Price to 0 gives free shipping — ideal for promotions or pickup scenarios.

Settings under Dropdown Select mode ​

When Dropdown Select is selected, configure a list of shipping methods for users to choose from:

Shipping Options ​

The core configuration of Dropdown Select mode, used to manage the selectable shipping methods. Each shipping method contains:

  • Label: Shipping method name (placeholder: Method, e.g., "Standard Shipping")
  • Value: Submitted value (placeholder: Value)
  • Price: Shipping fee amount (minimum 0)

Each shipping method provides the following action buttons:

ButtonDescription
✓ (Default)Set as the default selected method
🗑 (Remove)Delete this shipping method
+ (Add)Add a new shipping method below
📄 (Duplicate)Duplicate this shipping method
≡ (Sort)Drag to adjust the order

Click the Add Shipping Option button at the bottom to add a new shipping method.

Example

Common shipping method configurations:

  • Standard Shipping — 15 (delivered in 3-5 days)
  • Express Shipping — 30 (delivered in 1-2 days)
  • Pickup — 0 (free shipping)

"Please select" option ​

Whether to display a "Please select" prompt item at the top of the dropdown list. This option carries no value, so the user must explicitly select a shipping method.

Label Icon ​

An icon for the shipping field's label.

Settings under Radio Buttons mode ​

When Radio Buttons is selected, users choose a shipping method from a radio button list.

Shipping Options ​

Manages the selectable shipping methods, configured the same way as in Dropdown Select mode (Label / Value / Price + 5 action buttons + Add Shipping Option).

Options layout ​

The arrangement of the radio button shipping options. Available options:

  • Inline: Options arranged in a single row
  • One option per line: Each option on its own line
  • 2 columns ~ 10 columns: Options arranged in a 2-10 column grid

Layout suggestions

Use Inline or One option per line when there are few shipping methods; use a multi-column layout when there are many shipping methods to save space.

Settings under Card Selection mode ​

When Card Selection is selected, shipping methods appear as cards, suited to cases where you need to display logistics images and detailed information.

Shipping Options ​

Unlike other modes, Card Selection's shipping method list has an additional Image column to set an image for each shipping method (such as a logistics company logo):

  • Label: Shipping method name (placeholder: Method)
  • Value: Submitted value
  • Price: Shipping fee amount (minimum 0)
  • Image: Shipping method image (click the image button to select an image file)

The action buttons are the same as in other modes (default value/delete/add/duplicate/sort + Add Shipping Option).

Image suggestions

Adding a logistics company logo or shipping illustration to each shipping method makes Card Selection mode more visually appealing. We recommend using the same ratio and dimensions for all shipping method images.

Options layout ​

The arrangement of the shipping method cards. Available options:

  • Inline: Cards arranged in a single row
  • One option per line: Each card on its own line
  • 2 columns ~ 10 columns: Cards arranged in a 2-10 column grid

Image Ratio ​

The display ratio of the image in the shipping method cards. Available options:

RatioDescriptionSuitable scenarios
1:1 Square (default)SquareLogistics logos, icons
4:3 StandardStandard ratioTraditional logistics images
3:2 ClassicClassic ratioDSLR camera photos
16:9 WidescreenWidescreenBanner shipping images, vehicle images
2:1 PanoramicPanoramicWide display
3:4 PortraitPortraitVertical logistics images
2:3 Portrait TallTall portraitPoster-style display

Image ratio suggestions

Choose a ratio that suits your shipping method images, and use the same ratio for all shipping methods to keep the card layout uniform.

Included in total

Whether in Single, Dropdown Select, Radio Buttons, or Card Selection mode, the shipping fee is automatically included in the Total. Calculation formula: Total = Product price × Quantity + Shipping fee

Description ​

The description text for the shipping field, used to explain shipping-related information (e.g., "Delivered in 3-5 business days", "Free shipping nationwide").

Validate ​

The Shipping element supports only one validation rule:

ValidatorDescription
RequiredRequired; checks whether the user has selected a shipping method

Styles ​

Label position ​

The display position of the label. Available options:

  • Inherit: Uses the global configuration in Form style settings
  • Vertical: The label appears above the shipping field
  • Horizontal: The label appears to the left of the shipping field
  • Hidden: The label is hidden

Icon position ​

The display position of the label icon (shown in Dropdown Select mode). Available options:

  • Inherit: Uses the global configuration
  • Start: The icon is on the left
  • End: The icon is on the right

Data ​

Show in email ​

Whether this field appears in the email notifications (enabled by default). When disabled, this field is excluded from the submission email.

Advanced ​

Unique ID ​

The element's unique ID, auto-generated by the system and read-only.

Using e-commerce elements together ​

The elements required for a complete checkout flow:

ElementPurposeUser action
ProductSelect a productSelect the product to purchase
QuantityEnter quantityEnter the purchase quantity
TotalAuto-calculate totalAutomatically displayed (no action required)
ShippingSelect shippingSelect the shipping method

Complete checkout flow example

  1. Add a Product element and set the product name and price
  2. Add a Quantity element, link it to the Product, and set the quantity range
  3. Add a Shipping element and set the shipping methods and fees
  4. Add a Total element to automatically display the total amount (product + shipping)
  5. Configure payment settings to complete online payment collection

Next steps ​

Built with VitePress