Store Settings Mapping

This guide will help you migrate store settings from the old system to the new Vitrin theme structure.
All global store settings are now available under the settings object inside the store object.
The structure is reorganized and grouped into logical categories for easier access and maintenance.

Use this mapping to update your theme code and ensure settings are referenced from their new paths.

🎨 Branding

Brand-related settings (logo, colors, description, etc.) are now grouped under branding.

Type	New Path	Old Path
`string[url]`	`branding.logo`	`settings.logo`
`string[url]`	`branding.icon`	`settings.icon`
`string[url]`	`branding.cover`	`settings.cover`
`string`	`branding.description`	`settings.description`
`string`	`branding.copyrights`	`settings.copyright_meta.text`
`string[hex]`	`branding.colors.primary`	`settings.theme.colors.buttons.btn_default_background_color`
`string[hex]`	`branding.colors.on_primary`	`settings.theme.colors.buttons.btn_default_text_color`
`string[hex]`	`branding.colors.primary_variant`	`settings.theme.colors.buttons.btn_hover_background_color`
`string[hex]`	`branding.colors.secondary`	`settings.theme.colors.buttons.btn_pressed_background_color`
`string[hex]`	`branding.colors.on_secondary`	`settings.theme.colors.buttons.btn_pressed_text_color`
`string[hex]`	`branding.colors.secondary_variant`	`settings.theme.colors.buttons.btn_pressed_background_color`
`string`	`general.one_signal.ios_app_id`	`settings.apps.ios_app_id`
`string`	`general.one_signal.android_package_name`	`settings.apps.android_package_name`

⚙ General Settings

General store configuration such as currency, tax settings, availability, and app tabs.

New Path	Old Path	Type
`general.currency.*`	`settings.currency.*`	`Currency`
`general.business_address`	`footer.business_location`
`general.tax_settings.*`	`settings.vat_settings.*`	`TaxSettings`
`general.availability.*`	`settings.availability.*`	`Availability`
`general.mobile_app_tab.*`	`settings.mobile_app_tab_settings.*`
`general.mazeed.display_places.customer_profile_page`	`settings.mazeed_display_places.customer_profile_page`	`boolean`
`general.mazeed.display_places.order_success_page`	`settings.mazeed_display_places.order_success_page`	`boolean`
`general.mazeed.display_places.order_view_page`	`settings.mazeed_display_places.order_view_page`	`boolean`

Currency

Handles currency format, display, and exchange rates.

New Path	Old Path	Type
`general.currency.id`	`settings.currency.id`	`int`
`general.currency.name`	`settings.currency.name`	`string`
`general.currency.code`	`settings.currency.code`	`string`
`general.currency.symbol`	`settings.currency.symbol`	`string`
	`settings.currency.country`
`general.currency.symbol_left`		`string`
`general.currency.symbol_right`		`string`
`general.currency.format`		`string`
`general.currency.exchange_rate`		`string`

Tax Settings

VAT & tax-related settings.

New Path	Old Path	Type
`general.tax_settings.id`	`settings.vat_settings.id`	`uuid`
`general.tax_settings.country`		`string`
`general.tax_settings.tax_percentage`	`settings.vat_settings.tax_percentage`	`float`
`general.tax_settings.tax_number`	`settings.vat_settings.vat_number`	`string`
`general.tax_settings.tax_registration_certificate`	`settings.vat_settings.tax_registration_certificate`	`string[url]`
`general.tax_settings.is_certificate_visible`	`settings.vat_settings.is_certificate_visible`	`boolean`
`general.tax_settings.is_tax_number_visible`	`settings.vat_settings.is_vat_number_visible`	`boolean`
`general.tax_settings.tax_activate`	`settings.vat_settings.vat_activate`	`boolean`
`general.tax_settings.is_tax_self_paid`	`settings.vat_settings.is_vat_self_paid`	`boolean`
`general.tax_settings.is_tax_included_in_product_price`	`settings.vat_settings.is_vat_included_in_product_price`	`boolean`
`general.tax_settings.is_shipping_fee_included_in_tax`	`settings.vat_settings.is_shipping_fee_included_in_vat`	`boolean`
`general.tax_settings.can_use_tax`	`settings.vat_settings.can_use_vat`	`boolean`

Availability

Store open/close settings, display messages, and timing.

Type	New Path	Old Path
`boolean`	`general.availability.is_store_closed`	`settings.availability.is_store_closed`
`string`	`general.availability.closing_type`	`settings.availability.closing_type`
`string`	`general.availability.closing_time_type`	`settings.availability.closing_time_type`
`boolean`	`general.availability.closed_now`	`settings.availability.closed_now`
`dict`	`general.availability.activating_data`	`settings.availability.activating_data`
`dict`	`general.availability.closing_data`	`settings.availability.closing_data`
`boolean`	`general.availability.notify_customer`	`settings.availability.notify_customer`
`boolean`	`general.availability.is_time_counter_displayed`	`settings.availability.is_time_counter_displayed`
`boolean`	`general.availability.is_available_hours_visible`	`settings.availability.is_available_hours_visible`
`string`	`general.availability.title`	`settings.availability.title`
`string`	`general.availability.message`	`settings.availability.message`
`string`	`general.availability.times`	`settings.availability.times`

📞 Contact Information

Now consolidated under contact.

Type	New Path	Old Path
`string`	`contact.title`	`footer.social_media.title`
`string`	`contact.facebook`	`footer.social_media.items.facebook`
`string`	`contact.twitter`	`footer.social_media.items.twitter`
`string`	`contact.instagram`	`footer.social_media.items.instagram`
`string`	`contact.snapchat`	`footer.social_media.items.snapchat`
`string`	`contact.tiktok`	`footer.social_media.items.tiktok`
`string`	`contact.business_center`	`footer.social_media.items.business_center`
`string`	`contact.website`	`footer.social_media.items.website`
`string`	`contact.phone`	`footer.social_media.items.phone`
`string`	`contact.email`	`footer.social_media.items.email`

🏢 About Us

New Path	Old Path	Type
`about_us.title`	`footer.about_us.title`	`string`
`about_us.text`	`footer.about_us.text`	`string`

📢 Announcement Bar

New Path	Old Path
`announcement_bar.*`	`header.announcement_bar.*`

📋 Menus

New Path	Old Path
`menus.main_menu.*`	`header.menu_v2.` ↳ Children remain in `items/children` same as before*

📦 Products

(low stock labels, wishlist, reviews, filters, payment widgets)

Type	New Path	Old Path
`boolean`	`products.low_stock_label_enabled`	`settings.is_low_stock_label_enabled`
`int/none`	`products.low_stock_quantity_limit`	`settings.low_stock_quantity_limit`
`boolean`	`products.wishlist_enabled`	`settings.is_wishlist_enabled`
`boolean`	`products.reviews_enabled`	`settings.is_product_reviews_enabled`
`boolean`	`products.questions_enabled`	`settings.is_product_question_and_answer_enabled`
`boolean`	`products.filter_by_city`	`settings.is_filter_products_based_on_city`
`boolean`	`products.tamara_widget_enabled`	`settings.is_tamara_product_widget_enabled`
`boolean`	`products.tabby_widget_enabled`	`settings.is_tabby_product_widget_enabled`
`boolean`	`products.has_products_filtration`	`settings.has_new_products_service`
`boolean`	`products.is_metafields_enabled`	`settings.is_metafields_enabled`

👤 Customers

Type	New Path	Old Path
`boolean`	`customers.is_customers_email_mandatory`	`settings.is_customers_email_mandatory`
`boolean`	`customers.login_by_sms_enabled`	`settings.customers_login_by_sms_status`
`boolean`	`customers.login_by_email_enabled`	`settings.customers_login_by_email_status`
`boolean`	`customers.login_by_whatsapp_enabled`	`settings.customers_login_by_whatsapp_status`
`boolean`	`customers.gmaps_in_address_enabled`	`settings.is_gmaps_in_address_enabled`
`boolean`	`customers.gmaps_in_address_mandatory`	`settings.is_gmaps_in_address_mandatory`
`boolean`	`customers.spl_in_address_enabled`	`settings.is_spl_in_address_enabled`
`boolean`	`customers.gmaps_or_spl_enabled`	`settings.is_gmaps_and_spl_in_address_enabled`
`dict[string, any]`	`customers.google_maps`	`settings.google_maps`

💳 Checkout

(payment options, widgets, restrictions, guest checkout, addresses)

Type	New Path	Old Path
`boolean`	`checkout.reorder_enabled`	`settings.is_reorder_enabled`
`boolean`	`checkout.is_selling_blocked`	`settings.is_selling_blocked`
`boolean`	`checkout.is_international_charge_notice_enabled`	`settings.is_international_charge_notice_enabled`
`boolean`	`checkout.show_pickup_option_stock_availability_for_checkout`	`settings.show_pickup_option_stock_availability_for_checkout`
`boolean`	`checkout.is_different_consignee_allowed`	`settings.is_different_consignee_allowed`
`string`	`checkout.tamara_public_key`	`settings.tamara_public_key`
`boolean`	`checkout.is_tamara_cart_widget_enabled`	`settings.is_tamara_cart_widget_enabled`
... (list continues as in mapping above)

📜 App Scripts

Type	New Path	Old Path
`int`	`published_app_scripts[].id`	`settings.app_scripts[].script_id`
`string`	`published_app_scripts[].url`	`settings.app_scripts[].url`
`boolean`	`published_app_scripts[].status`	`settings.app_scripts[].status`
`int`	`published_app_scripts[].app_id`	`settings.app_scripts[].app_id`
`string`	`published_app_scripts[].version`	`settings.app_scripts[].version`

✅ Next Step: After updating your settings references, test your theme in a staging environment to confirm all features and visual elements render correctly.

Store Settings Mapping

🎨 Branding#

⚙ General Settings#

Currency#

Tax Settings#

Availability#

📞 Contact Information#

🏢 About Us#

📢 Announcement Bar#

📋 Menus#

📦 Products#

👤 Customers#

💳 Checkout#

📜 App Scripts#

🎨 Branding

⚙ General Settings

Currency

Tax Settings

Availability

📞 Contact Information

🏢 About Us

📢 Announcement Bar

📋 Menus

📦 Products

👤 Customers

💳 Checkout

📜 App Scripts