Configuration Fields

This reference lists the settings exposed by mageb2b/onestepcheckout in Magento Admin.

Configuration paths are included for controlled deployments and config:set. Use Magento Admin for normal changes so field validation and scope inheritance still apply. The extension status display is not listed because it reports installation state rather than a configurable value.

General Settings

Field	Configuration path	Input	Scope
Enable One Step Checkout	`onestepcheckout/general/enabled`	Select	Default, Website, Store view
Checkout Title	`onestepcheckout/general/title`	Text	Default, Website, Store view
Checkout Description	`onestepcheckout/general/description`	Text area	Default, Website, Store view
Allow Guest Checkout	`onestepcheckout/general/allow_guest`	Select	Default, Website, Store view

Visibility dependencies:

onestepcheckout/general/title is available when onestepcheckout/general/enabled is 1.
onestepcheckout/general/description is available when onestepcheckout/general/enabled is 1.
onestepcheckout/general/allow_guest is available when onestepcheckout/general/enabled is 1.

Design Settings

Field	Configuration path	Input	Scope
Primary Color Override (Hex)	`onestepcheckout/design/primary_color`	Custom control	Default, Website, Store view
Page Background Override (Hex)	`onestepcheckout/design/bg_light`	Custom control	Default, Website, Store view
Background Dark (Hex)	`onestepcheckout/design/bg_dark`	Custom control	Default, Website, Store view
Text Color (Hex)	`onestepcheckout/design/text_color`	Custom control	Default, Website, Store view
Border Radius	`onestepcheckout/design/border_radius`	Select	Default, Website, Store view
Font Family	`onestepcheckout/design/font_family`	Text	Default, Website, Store view
Button Text Color Override	`onestepcheckout/design/btn_text_color`	Custom control	Default, Website, Store view
Header Background Color	`onestepcheckout/design/header_bg`	Custom control	Default, Website, Store view
Header Layout	`onestepcheckout/design/page_chrome`	Select	Default, Website, Store view

Checkout Block Layout

Field	Configuration path	Input	Scope
Drag & Drop Layout Builder	`onestepcheckout/layout_blocks/layout_builder_map`	Custom control	Default, Website, Store view

Step Functionality

Field	Configuration path	Input	Scope
Billing same as Shipping default	`onestepcheckout/functionality/billing_same_as_shipping`	Select	Default, Website, Store view
Enable Coupon	`onestepcheckout/functionality/enable_coupon`	Select	Default, Website, Store view
Enable Gift Card	`onestepcheckout/functionality/enable_giftcard`	Select	Default, Website, Store view
Enable Authentication (Login/Register/Guest Toggle)	`onestepcheckout/functionality/enable_authentication`	Select	Default, Website, Store view
Terms and Conditions Position	`onestepcheckout/functionality/agreements_position`	Select	Default, Website, Store view

The Terms and Conditions Position field offers Order Summary (below discount code) (default) and Payment Method. It controls where Magento's terms-and-conditions block appears on the one-step checkout page.

Shipping Address Fields

Field	Configuration path	Input	Scope
Shipping Order	`onestepcheckout/field_order/shipping_order`	Custom control	Default, Website, Store view
Shipping Field Builder	`onestepcheckout/shipping_fields/field_behavior_map`	Custom control	Default, Website, Store view

Billing Address Fields

Field	Configuration path	Input	Scope
Billing Order	`onestepcheckout/field_order/billing_order`	Custom control	Default, Website, Store view
Billing Field Builder	`onestepcheckout/billing_fields/field_behavior_map`	Custom control	Default, Website, Store view

Extra Features

Field	Configuration path	Input	Scope
Enable Order Comment	`onestepcheckout/extras/enable_order_comment`	Select	Default, Website, Store view
Enable Newsletter Subscription	`onestepcheckout/extras/enable_newsletter`	Select	Default, Website, Store view
Newsletter Checked by Default	`onestepcheckout/extras/newsletter_checked_default`	Select	Default, Website, Store view
Enable Delivery Date	`onestepcheckout/extras/enable_delivery_date`	Select	Default, Website, Store view
Minimum Lead Time (days)	`onestepcheckout/extras/delivery_date_min_days`	Text	Default, Website, Store view
Maximum Advance (days)	`onestepcheckout/extras/delivery_date_max_days`	Text	Default, Website, Store view
Disabled Weekdays	`onestepcheckout/extras/delivery_date_disabled_weekdays`	Multi-select	Default, Website, Store view
Holiday Calendar Country	`onestepcheckout/extras/delivery_date_holiday_country`	Select	Default, Website, Store view
Additional Blackout Dates	`onestepcheckout/extras/delivery_date_blackout`	Text area	Default, Website, Store view
Google Places API Key	`onestepcheckout/extras/google_places_api_key`	Protected text	Default, Website, Store view
Google Places Country Restriction	`onestepcheckout/extras/google_places_country_restrict`	Multi-select	Default, Website, Store view
Enable Live Field Validation	`onestepcheckout/extras/enable_live_validation`	Select	Default, Website, Store view
Enable Trust Badges	`onestepcheckout/extras/enable_trust_badges`	Select	Default, Website, Store view
Trust Badges HTML	`onestepcheckout/extras/trust_badges_content`	Text area	Default, Website, Store view
Enable Gift Message	`onestepcheckout/extras/enable_gift_message`	Select	Default, Website, Store view

Visibility dependencies:

onestepcheckout/extras/newsletter_checked_default is available when onestepcheckout/extras/enable_newsletter is 1.
onestepcheckout/extras/delivery_date_min_days is available when onestepcheckout/extras/enable_delivery_date is 1.
onestepcheckout/extras/delivery_date_max_days is available when onestepcheckout/extras/enable_delivery_date is 1.
onestepcheckout/extras/delivery_date_disabled_weekdays is available when onestepcheckout/extras/enable_delivery_date is 1.
onestepcheckout/extras/delivery_date_holiday_country is available when onestepcheckout/extras/enable_delivery_date is 1.
onestepcheckout/extras/delivery_date_blackout is available when onestepcheckout/extras/enable_delivery_date is 1.
onestepcheckout/extras/trust_badges_content is available when onestepcheckout/extras/enable_trust_badges is 1.

GA4 Tracking

Field	Configuration path	Input	Scope
GA4 Measurement ID	`onestepcheckout/ga4/ga4_id`	Text	Default, Website, Store view

Success Page

Field	Configuration path	Input	Scope
Enable Custom Success Page	`onestepcheckout/success_page/enabled`	Select	Default, Website, Store view
Layout	`onestepcheckout/success_page/layout_columns`	Select	Default, Website, Store view

Visibility dependencies:

onestepcheckout/success_page/layout_columns is available when onestepcheckout/success_page/enabled is 1.

Cart Recovery

Field	Configuration path	Input	Scope
Enable	`onestepcheckout/cart_recovery/enable`	Select	Default, Website, Store view
Email Template	`onestepcheckout/cart_recovery/template_id`	Select	Default, Website, Store view
Threshold (minutes)	`onestepcheckout/cart_recovery/abandon_threshold`	Text	Default, Website, Store view
Missing Email Retry Interval (hours)	`onestepcheckout/cart_recovery/retry_interval_hours`	Text	Default, Website, Store view
Maximum Missing Email Attempts	`onestepcheckout/cart_recovery/max_retry_attempts`	Text	Default, Website, Store view
Existing Cart	`onestepcheckout/cart_recovery/existing_cart_strategy`	Select	Default, Website, Store view

Visibility dependencies:

onestepcheckout/cart_recovery/template_id is available when onestepcheckout/cart_recovery/enable is 1.
onestepcheckout/cart_recovery/abandon_threshold is available when onestepcheckout/cart_recovery/enable is 1.
onestepcheckout/cart_recovery/retry_interval_hours is available when onestepcheckout/cart_recovery/enable is 1.
onestepcheckout/cart_recovery/max_retry_attempts is available when onestepcheckout/cart_recovery/enable is 1.
onestepcheckout/cart_recovery/existing_cart_strategy is available when onestepcheckout/cart_recovery/enable is 1.

Multi-Address Shipping

Field	Configuration path	Input	Scope
Enable	`onestepcheckout/multi_address/enable`	Select	Default, Website, Store view

Settings without an Admin field

Two summary settings have no Admin control and can only be changed through config:set or a config.xml default:

Configuration path	Effect	Default
`onestepcheckout/summary/show_taxes`	Includes the tax row in the order-summary totals when enabled. The Hyva checkout reads this flag directly.	`1`
`onestepcheckout/summary/show_image`	Shows product thumbnails in the order-summary item list. The Hyva checkout reads this flag directly.	`1`

Both are exported into the checkout configuration under summary. Set them per store scope, for example php bin/magento config:set --scope=stores --scope-code=<code> onestepcheckout/summary/show_image 0.