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 |
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.* |
| 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.
