📍
Bolt Help / Dashboard / Checkout Settings / Custom UI Copy
This feature enables you to override Bolt's default messaging within the Checkout modal.
About
Custom UI Copy enables merchants to change the Bolt Checkout modal’s default messaging across most of its major touch points, including: discount application, shipping detail entry, and error messages. These customizations are available on the division-level, meaning you can craft unique messaging for each storefront associated to your merchant account.
Reach out to Bolt Support to update the Bolt Checkout modal’s UI copy.
Availability
| Platform | Supported Products |
|---|---|
|
Custom Cart / Direct API |
Supported for Bolt Embedded Accounts. |
UI Customization Options
Use the following lists to compile all of your Custom UI Copy changes.
Discount
| Text Key | Default Text |
|---|---|
| discount/applied | DISCOUNT APPLIED |
| discount/apply | APPLY |
| discount/codePlaceholder | DISCOUNT |
| discount/error | Discount is not applicable |
| discount/invalid | Invalid discount |
| discount/label | Discount |
| discount/label-plural | Discounts |
| discount/link | + DISCOUNT |
| discount/offer_claimed | OFFER CLAIMED |
| discount/remove_error | Sorry we weren’t able to remove {{ discount_code }}. Please try again. |
Gift Card
| Text Key | Default Text |
|---|---|
| giftCard/cardNumber | Card number |
| giftCard/inputTitle | Enter Gift/E-Gift/Store credit |
| giftCard/invalid | Invalid Card Number or PIN |
| giftCard/label | Ending in |
| giftCard/link | + GIFT/E-GIFT/STORE CREDIT |
| giftCard/pinNumber | PIN |
| giftCard/title | Gift Card |
Cart
| Text Key | Default Text |
|---|---|
| cart/delivery | Delivery |
| cart/discount | Discount |
| cart/orderSummary | Order Summary |
| cart/shipping | Shipping |
| cart/subtotal | Subtotal |
| cart/tax | Tax |
| cart/taxes | Taxes |
| cart/total | Total |
| cart/updating | Updating… |
Shipping Details Form
TIP
To improve the speed and performance of the checkout bundle, the system only renders flags for the ten (10) most commonly-used countries (shippingInfo/form/phone/countryCode/flagicon/img/alt).
| Text Key | Default Text |
|---|---|
| shippingInfo/form/addAddressLine2Link | + APARTMENT, BUILDING, FLOOR |
| shippingInfo/form/addressLine1/error/missing | Address required |
| shippingInfo/form/addressLine1/error/unsupported | Unsupported shipping (PO box) |
| shippingInfo/form/addressLine1/label | Street address |
| shippingInfo/form/addressLine2/error/missing | Address required |
| shippingInfo/form/addressLine2/error/unsupported | Unsupported shipping (PO box) |
| shippingInfo/form/addressLine2/label | Apartment, building, floor (optional) |
| shippingInfo/form/city/error/missing | City required |
| shippingInfo/form/city/label | City |
| shippingInfo/form/company/button | + Add Company |
| shippingInfo/form/company/error/missing | Company name required |
| shippingInfo/form/company/label | Company name |
| shippingInfo/form/company/label/optional | Company name (optional) |
| shippingInfo/form/country/error/missing | Country required |
| shippingInfo/form/country/error/notsupported | Can’t ship to country |
| shippingInfo/form/country/select/label | Country |
| shippingInfo/form/email/error/invalid | Invalid email |
| shippingInfo/form/email/error/missing | Email required |
| shippingInfo/form/firstName/error/limit | First name too long |
| shippingInfo/form/firstName/error/missing | First name required |
| shippingInfo/form/firstName/label | First name |
| shippingInfo/form/lastName/error/limit | Last name too long |
| shippingInfo/form/lastName/error/missing | Last name required |
| shippingInfo/form/lastName/label | Last name |
| shippingInfo/form/phone/countryCode/flagicon/img/alt | country code selected |
| shippingInfo/form/phone/countryCode/label | Select Country Code |
| shippingInfo/form/phone/error/invalid | Invalid phone |
| shippingInfo/form/phone/error/missing | Phone required |
| shippingInfo/form/postalCode/error/invalid | Invalid postal code |
| shippingInfo/form/postalCode/error/missing | Postal code required |
| shippingInfo/form/province/error/invalid | Invalid Province |
| shippingInfo/form/province/select/label | Province |
| shippingInfo/form/region/error/invalid | Invalid Region |
| shippingInfo/form/region/select/label | Region |
| shippingInfo/form/state/error/invalid | Invalid State |
| shippingInfo/form/state/error/notsupported | Can’t ship to state |
| shippingInfo/form/state/select/label | State |
| shippingInfo/form/state/textInput/label | Region/Province |
| shippingInfo/form/zip/error/invalid | Invalid ZIP |
| shippingInfo/form/zip/error/missing | ZIP required |
| shippingInfo/form/zip/label | ZIP |
Shipping Options
| Text Key | Default Text |
|---|---|
| shippingOptions/addDeliveryNotes | + ADD DELIVERY NOTES |
| shippingOptions/deliveryNoteLabel | Delivery notes |
| shippingOptions/estimatedDeliveryDate | Estimated Delivery Date: |
| shippingOptions/mobile/collapsed | Standard shipping |
| shippingOptions/mobile/error | We were unable to find any delivery options. Please try again or enter an alternative address. |
| shippingOptions/mobile/loadingFirst | Finding available options… |
| shippingOptions/mobile/loadingSecond | Still finding delivery options. Go ahead and enter your payment first… |
| shippingOptions/mobile/tryAgain | TRY AGAIN |
| shippingOptions/selectShipping/loadMoreOptions | + Load more options |
| shippingOptions/selectShipping/loadingMoreOptions/guest | Continue below or wait for more options |
| shippingOptions/selectShipping/loadingMoreOptions/loggedIn | Pay now or wait for more options |
| shippingOptions/selectShipping/selectShippingOption | Select shipping option |
| shippingOptions/selectShipping/showMoreOptions | + Show more options |
Order Notes
| Text Key | Default Text |
|---|---|
| orderNotes/label | Order notes (optional) |
| orderNotes/placeholder | Delivery, gift, or special instructions |
Payment Form
| Text Key | Default Text |
|---|---|
| payment/form/cardNumber/label | Card number |
| payment/form/ccn/error/invalid | Invalid card number |
| payment/form/ccn/error/missing | Card number required |
| payment/form/ccn/error/unsupported | Unsupported card network |
| payment/form/complete | Complete order |
| payment/form/cvv/error/invalid | Invalid CVV |
| payment/form/cvv/error/missing | CVV required |
| payment/form/cvv/fourDigit/tooltip | The CVV/Security Code is the 4-digit code on the front of your card. |
| payment/form/cvv/label | CVV |
| payment/form/cvv/threeDigit/tooltip | The 3-digit CVV is placed on the back of most cards. American Express uses 4-digits on the front. |
| payment/form/exp/label | Expiration |
| payment/form/expiry/error/expired | Card expired |
| payment/form/expiry/error/invalid | Invalid expiration |
| payment/form/expiry/error/missing | Expiration required |
| payment/form/firstName/label | First name |
| payment/form/lastName/label | Last name |
| payment/form/loading | Loading |
| payment/form/payButton | Pay {{ amount }} |
| payment/form/processing | Processing |
| payment/form/securityAndPrivacy | We protect your payment information using encryption to provide bank-level security. |
| payment/form/securityAndPrivacy/short | We provide bank-level encryption and security. |
| payment/form/zip/label | ZIP |
| payment/form/zip/placeholder | ZIP |
Custom Notices
See our dedicated Custom Notices reference article for more information.
| Text Key | Default Text |
|---|---|
| order/customNotice | None |
| payment/customNotice | None |
| shipping/customNotice | None |
| shippingInfo/customNotice | None |
Errors
| Text Key | Default Text |
|---|---|
| error/address | Invalid Shipping Address! |
| error/amountTooLow | Order amount too low |
| error/authorize/tooManyRequests | Your order was not processed due to abnormally high traffic on our website. Please try again in a few minutes. If you are unable to check out after your next attempt, reach out to {{ merchantSupportEmail }} for assistance. |
| error/checkout/tooManyRequests | Our system is currently experiencing high traffic. Please click exit checkout and wait a few minutes before trying again. |
| error/codeAlreadyUsed | Code already used |
| error/discount | Discount is not valid. |
| error/discountCannotBeRemoved | Error: discount not removed |
| error/discountCodeExpired | Code has expired |
| error/discountCodeInsufficientInformation | Error: code not applied |
| error/discountCodeInvalid | Code does not exist |
| error/discountCodeItemsNotEligible | Ineligible items in cart |
| error/discountCodeLimitReached | Exceeded usage limit |
| error/discountCodeMinCartAmountRequired | Order amount too low |
| error/discountCodeNotAvailable | Promo hasn’t started |
| error/discountCodeRequiresPlatformLogin | Code requires login |
| error/discountCodeUniqueEmailRequired | Code already used |
| error/giftCardBalanceEmpty | Gift card has an empty balance |
| error/giftCardHasInsufficientFund | Gift card has insufficient funds |
| error/giftCardNumberInvalid | Gift card number is invalid |
| error/giftCardPinInvalid | Gift card pin is invalid |
| error/invalidOrder | Invalid order! |
| error/maxAmount | Order total is too big! |
| error/mobile/requiredCheckbox | You must check the box above to proceed. |
| error/noApplicableItem | No eligible items found |
| error/order | Something went wrong. |
| error/orderCreation | Please refresh the page and attempt to checkout again. If the problem persists, reach out to {{ email }} to complete your transaction. |
| error/paymentDeclined | Your payment was declined. Please enter a new payment method. |
| error/poBox | Address with P.O. Box is not allowed. |
| error/requiredCheckbox | Please acknowledge the notice by checking the box to proceed. |
| error/requiredCustomField | Please acknowledge the notice by filling out all required fields to proceed. |
| error/shipping | Delivery is not available for this order. |
| error/shippingCostTooHigh | Delivery method ineligible |
| error/timeout | Service timeout occurred. |
| error/unable | Unable to checkout |
| error/undeliverable | This address is not deliverable according to the USPS |
| error/undeliverableAddressFieldPrompt | Enter a new address |
| error/updateCardTryLater | Please update your cart or try again later. |
| error/userNotEligible | Error: code not applied |
| errors/no_shipping_options_details | Please verify your shipping state and postal code. If the error persists, contact {{ support_email }} to complete your transaction. |
PayPal
| Text Key | Default Text |
|---|---|
| paypalBilling/completeText | Complete your transaction via PayPal. |
| paypalBilling/connectedSubText | Pay with PayPal |
| paypalBilling/connectedText | Connected to PayPal |
| paypalBilling/label | Paypal |
| paypalBilling/newTab | PayPal will open in a new tab. |
Account
| Text Key | Default Text |
|---|---|
| accountCreation/networkBullet2 | Shop hundreds of <1></1> with Bolt’s passwordless login |
| accountCreation/securityBullet2 | Bank-level security & account protection |
| accountCreation/stores | stores |
| accountCreation/trackOrderBullet2 | Real-time tracking updates in select stores |
| accountCreation/updatedText | Save my information for a faster checkout |