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] | store.settings.branding.logo | store.logo |
string[url] | store.settings.branding.icon | store.icon |
string[url] | store.settings.branding.cover | store.cover |
string | store.settings.branding.description | store.description |
string | store.settings.branding.copyrights | store.copyrights |
string[hex] | store.settings.branding.colors.primary | store.colors.primary |
string[hex] | store.settings.branding.colors.on_primary | store.colors.text_of_primary_bg |
string[hex] | store.settings.branding.colors.primary_variant | store.colors.primary |
string[hex] | store.settings.branding.colors.secondary | store.colors.primary |
string[hex] | store.settings.branding.colors.on_secondary | store.colors.text_of_primary_bg |
string[hex] | store.settings.branding.colors.secondary_variant | store.colors.primary |
string | store.settings.general.one_signal.ios_app_id | store.apps.ios_app_id |
string | store.settings.general.one_signal.android_package_name | store.apps.android_package_name |
⚙ General Settings#
General store configuration such as currency, tax settings, availability, and app tabs.| New Path | Old Path | Type |
|---|
store.settings.general.currency.* | store.currency | Currency |
store.settings.general.business_address | store.business_location | |
store.settings.general.tax_settings.* | store.vat_settings | TaxSettings |
store.settings.general.availability.* | store.availability | Availability |
store.settings.general.mobile_app_tab.* | store.mobile_app_tab_settings | |
store.settings.general.mazeed.display_places.customer_profile_page | store.mazeed_display_places.customer_profile_page | boolean |
store.settings.general.mazeed.display_places.order_success_page | store.mazeed_display_places.order_success_page | boolean |
store.settings.general.mazeed.display_places.order_view_page | store.mazeed_display_places.order_view_page | boolean |
Currency#
Handles currency format, display, and exchange rates.| New Path | Old Path | Type |
|---|
store.settings.general.currency.id | store.currency.id | int |
store.settings.general.currency.name | store.currency.name | string |
store.settings.general.currency.code | store.currency.code | string |
store.settings.general.currency.symbol | store.currency.symbol | string |
| store.currency.country | |
store.settings.general.currency.symbol_left | | string |
store.settings.general.currency.symbol_right | | string |
store.settings.general.currency.format | | string |
store.settings.general.currency.exchange_rate | | string |
Tax Settings#
VAT & tax-related settings.| New Path | Old Path | Type |
|---|
store.settings.general.tax_settings.id | store.vat_settings.id | uuid |
store.settings.general.tax_settings.country | | string |
store.settings.general.tax_settings.tax_percentage | store.vat_settings.tax_percentage | float |
store.settings.general.tax_settings.tax_number | store.vat_settings.vat_number | string |
store.settings.general.tax_settings.tax_registration_certificate | store.vat_settings.tax_registration_certificate | string[url] |
store.settings.general.tax_settings.is_certificate_visible | store.vat_settings.is_certificate_visible | boolean |
store.settings.general.tax_settings.is_tax_number_visible | store.vat_settings.is_vat_number_visible | boolean |
store.settings.general.tax_settings.tax_activate | store.vat_settings.vat_activate | boolean |
store.settings.general.tax_settings.is_tax_self_paid | store.vat_settings.is_vat_self_paid | boolean |
store.settings.general.tax_settings.is_tax_included_in_product_price | store.vat_settings.is_vat_included_in_product_price | boolean |
store.settings.general.tax_settings.is_shipping_fee_included_in_tax | store.vat_settings.is_shipping_fee_included_in_vat | boolean |
store.settings.general.tax_settings.can_use_tax | store.vat_settings.can_use_vat | boolean |
Availability#
Store open/close settings, display messages, and timing.| Type | New Path | Old Path |
|---|
boolean | store.settings.general.availability.is_store_closed | store.availability.is_store_closed |
string | store.settings.general.availability.closing_type | store.availability.closing_type |
string | store.settings.general.availability.closing_time_type | store.availability.closing_time_type |
boolean | store.settings.general.availability.closed_now | store.availability.closed_now |
dict | store.settings.general.availability.activating_data | store.availability.activating_data |
dict | store.settings.general.availability.closing_data | store.availability.closing_data |
boolean | store.settings.general.availability.notify_customer | store.availability.notify_customer |
boolean | store.settings.general.availability.is_time_counter_displayed | store.availability.is_time_counter_displayed |
boolean | store.settings.general.availability.is_available_hours_visible | store.availability.is_available_hours_visible |
string | store.settings.general.availability.title | store.availability.title |
string | store.settings.general.availability.message | store.availability.message |
string | store.settings.general.availability.times | store.availability.times |
Now consolidated under contact.| Type | New Path | Old Path |
|---|
string | store.settings.contact.title | store.social_media.title |
string | store.settings.contact.facebook | store.social_media.items.facebook |
string | store.settings.contact.twitter | store.social_media.items.twitter |
string | store.settings.contact.instagram | store.social_media.items.instagram |
string | store.settings.contact.snapchat | store.social_media.items.snapchat |
string | store.settings.contact.tiktok | store.social_media.items.tiktok |
string | store.settings.contact.business_center | store.social_media.items.business_center |
string | store.settings.contact.website | store.social_media.items.website |
string | store.settings.contact.phone | store.social_media.items.phone |
string | store.settings.contact.email | store.social_media.items.email |
🏢 About Us#
This only applies if your theme was previously relying on the title and the text coming from the template settings. The new way uses the store settings object.
| New Path | Old Path | Type |
|---|
store.settings.about_us.title | store.about_us.title | string |
store.settings.about_us.text | store.about_us.text | string |
📢 Announcement Bar#
| New Path | Old Path |
|---|
store.settings.announcement_bar.* | store.announcement_bar.* |
| New Path | Old Path |
|---|
store.settings.menus.main_menu.* | store.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 | store.settings.products.low_stock_label_enabled | store.is_low_stock_label_enabled |
int/none | store.settings.products.low_stock_quantity_limit | store.low_stock_quantity_limit |
boolean | store.settings.products.wishlist_enabled | store.is_wishlist_enabled |
boolean | store.settings.products.reviews_enabled | store.is_product_reviews_enabled |
boolean | store.settings.products.questions_enabled | store.is_product_question_and_answer_enabled |
boolean | store.settings.products.filter_by_city | store.is_filter_products_based_on_city |
boolean | store.settings.products.tamara_widget_enabled | store.is_tamara_product_widget_enabled |
boolean | store.settings.products.tabby_widget_enabled | store.is_tabby_product_widget_enabled |
boolean | store.settings.products.has_products_filtration | store.has_new_products_service |
boolean | store.settings.products.is_metafields_enabled | store.is_metafields_enabled |
👤 Customers#
| Type | New Path | Old Path |
|---|
boolean | store.settings.customers.is_customers_email_mandatory | store.is_customers_email_mandatory |
boolean | store.settings.customers.login_by_sms_enabled | store.customers_login_by_sms_status |
boolean | store.settings.customers.login_by_email_enabled | store.customers_login_by_email_status |
boolean | store.settings.customers.login_by_whatsapp_enabled | store.customers_login_by_whatsapp_status |
boolean | store.settings.customers.gmaps_in_address_enabled | store.is_gmaps_in_address_enabled |
boolean | store.settings.customers.gmaps_in_address_mandatory | store.is_gmaps_in_address_mandatory |
boolean | store.settings.customers.spl_in_address_enabled | store.is_spl_in_address_enabled |
boolean | store.settings.customers.gmaps_or_spl_enabled | store.is_gmaps_and_spl_in_address_enabled |
dict[string, any] | store.settings.customers.google_maps | store.google_maps |
💳 Checkout#
(payment options, widgets, restrictions, guest checkout, addresses)| Type | New Path | Old Path |
|---|
boolean | store.settings.checkout.reorder_enabled | store.is_reorder_enabled |
boolean | store.settings.checkout.is_selling_blocked | store.is_selling_blocked |
boolean | store.settings.checkout.is_international_charge_notice_enabled | store.is_international_charge_notice_enabled |
boolean | store.settings.checkout.show_pickup_option_stock_availability_for_checkout | store.show_pickup_option_stock_availability_for_checkout |
boolean | store.settings.checkout.is_different_consignee_allowed | store.is_different_consignee_allowed |
string | store.settings.checkout.tamara_public_key | store.tamara_public_key |
boolean | store.settings.checkout.is_tamara_cart_widget_enabled | store.is_tamara_cart_widget_enabled |
list | store.settings.checkout.payment_methods | store.payment_methods |
object | store.settings.checkout.gift_order_settings | store.gift_order_settings |
📜 App Scripts#
| Type | New Path | Old Path |
|---|
int | store.settings.published_app_scripts[].id | store.app_scripts[].script_id |
string | store.settings.published_app_scripts[].url | store.app_scripts[].url |
boolean | store.settings.published_app_scripts[].status | store.app_scripts[].status |
int | store.settings.published_app_scripts[].app_id | store.app_scripts[].app_id |
string | store.settings.published_app_scripts[].version | store.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.
