Configure JSON

For more flexibility in Checkout configuration, you can edit JSON configuration file directly and customize properties on a granular level.

You can enable/disable features, define currency and formats, setup dynamic fields (phone number, birthdate, checkboxes, etc.), specify external links (terms and conditions, privacy policy, etc.), and customize address forms per country according to your requirements.

We strongly recommend to configure Checkout frontend UI to avoid braking JSON file. The full list of option editable in the UI is available in the User Guide.

Translate Checkout texts

All texts such as labels of input fields can be translated in the localization engine Crowdin. The process is explained in the Translation section.

Access JSON file

Go to Shops > Shop > Storefront > Checkout Settings.
Select Checkout Frontend Configuration to access the configuration area

There is a backend validation for different fields and a restriction on the database level for maximum and minimum values. If you set specific frontend validations they should be aligned with your backend logic.

Overwrites

Checkout uses a default configuration which reflects the baseline requirements for most shops. However, many shops have small deviations from the default configuration. These differences have to be modified for each country and locale. SCAYLE Checkout, therefore, uses country and locale specific overwrites.

Available properties

The following pages provide more details and examples for configuration properties, including:

Address Forms and Field Validation configure address forms and set constraints on fields (e.g., min/max length, input format).
Compatibility Fixes set values for notification header dimensions.
Country and locale-specific overwrites
Currency, dates & formats define which currency is used and set date formats
Dynamic Fields configure fields such as birth date and phone number
Features set parameters for activating special checkout features.
HTML Slots
Links specify links that appear within translation strings (e.g., terms and conditions)
Notifications configure static notifications
Shipment & Delivery Options set carrier options and collection points.
Tracking events