Widget Use

Presents the various shipping methods available to the user during checkout. Each option and its associated cost are displayed so that the user can make their selection before proceeding to payment.

The widget is also used to present pickup locations when Store Pickup functionality is enabled.

Example of Widget Use

Following is an example of the widget in use:

Where can the Widget be placed?

The widget can be used in the following templates:

  • Checkout Template
  • Checkout Quote Template
  • Guest Checkout Template
  • PayPal Express Template

Widget Options

OptionUseCommentsAvailable from Version
DescriptionA short description of the widget's use.We recommend this field be updated so the widget's purpose is clear at a glance from the template page.All
LayerThe layer the widget is valid for.

The layering technology allows for the content to be shown to specific audiences.

This is handy if the content is only valid for a certain type of user or if the same widget is required for more than one audience but different configurations are needed.

The widget can be added to the zone more than once and the layer feature can determine which audience can see each widget. 

Show Widget Before Freight Options Are Known?Determines whether this widget displays before freight options are known. 

Default: ON

Toggle to disable

Show GST Suffix?Determines whether to include the (ex GST) or (inc GST) suffix against each charge option.

Default: ON

Toggle to disable

Zero Dollar Freight Charge DisplayThe text displayed when the freight option does not attract a charge due to the user meeting a spend threshold.Default: No ChargeAll
Freight Quote DisplayDetermines whether freight quote is displayed.Default: To Be Confirmed
Map Link TextThe text displayed for the location map hyperlink.Default: mapAll
Auto Select Single Pickup Warehouse?Determines whether a pickup location is automatically selected if it is the only one available.

Default: OFF

Toggle to enable

Postcode Required Before Error Notifications ShownDetermines whether freight error popup message will display before the user enters a postcode.

Default: OFF

Toggle to enable

Freight Options HeadingThe heading text displayed at the top of the widget.Default: Freight OptionsAll
Freight Options Heading IconThe icon displayed to the left of the heading text.

Default is: cv-ico-general-shipping

Select via drop-down

Pickup Locations HeadingThe heading text displayed above the Pickup Locations section.

Default: Pickup Location

NOTE - An 's' is automatically appended when there are multiple pickup warehouses.

Pickup Locations Heading IconThe icon displayed to the left of the Pickup Locations Heading text.

Default: cv-ico-general-location

Select via drop-down

No Own Carrier Name MessageThe message text displayed when Own Carriers are enabled but the user has not yet selected.Default: Please select one of your own carriersAll
No Own Carrier Account MessageThe message text displayed for the Own Carrier Account Number field.Default: Please enter your Freight Account NumberAll
Freight Option Not Selected MessageThe message text displayed when no Freight Option selection has been made.Default: Please select a freight optionAll
No Normal Carrier MessageThe message text displayed when the user has opted to include freight on order, but hasn't selected a specific option.Default: Please select one freight option on order3.88
Freight Recalculation On Quote Acceptance MessageThe message displayed when the user submits the order as a quote and the freight recalculation is on. (For the Online Quote mode only) Default: The freight for this quote may have changed. Please reselect.4.37
GST PromptThe text displayed in the GST Suffix with either 'ex' or 'inc'.Default: GSTAll
Pickup Location List LabelThe prompt text displayed when the user has not yet selected a pickup location.Default: Select Pickup LocationAll
Select Warehouse LabelThe button text displayed against each possible pickup location.Default: Select WarehouseAll
Select Freight On OrderThe prompt text displayed above the freight options.Default: Select freight on order3.88
Select Own Freight LabelThe prompt text displayed above the user's list of own carriers.Default: Select from your list of own carriers3.88
Free Delivery LabelThe text displayed when the freight has been charged at $0 due to a promotion or freight quote requirement.Default: Free Delivery Promotion Applied3.90
Freight Protection Insurance
Freight Insurance 'Accepted' Label
Default: Freight protection4.00
Freight Insurance 'Declined' Label
Default: No, I do not want my order insured4.00
Freight Insurance Heading 
Default: Would you like freight protection insurance?4.00
Freight Insurance Label 
Default: We will cover any loss or damage to your goods that may occur during freight.4.00
Tailgate Service
Tailgate Service 'Accepted' Label
Default: Tailgate Service4.00
Tailgate Service 'Declined' Label
Default: No, I have a forklift that I can unload my goods with4.00
Tailgate Service Heading
Default: Do you require a Tailgate delivery service?4.00
Tailgate Service Label
Default: You have items in your order that require a forklift to unload and cannot be unloaded by hand.4.00
Dangerous Goods
Dangerous Goods Surcharge TextThe text added to a freight estimate or charge displayed if the dangerous goods surcharge feature is active.Default:  (includes dangerous goods surcharge)4.00

Related help