The shop object contains your store’s fundamental settings and configuration. It’s available globally across all pages and templates, making it perfect for headers, footers, and any store-wide functionality.
Usage : Available globally - use anywhere in your templates to access store information
Access your store’s core details that you’ve configured in the Control Panel:
<!-- Store name and URL --> <header> <h1><a href="{{shop.url}}">{{shop.name}}</a></h1> </header> <!-- Contact information --> <footer> <div class="contact-info"> <h3>Contact Us</h3> <p>{{shop.address}}</p> <p>{{shop.zipcode}} {{shop.city}}</p> <p>Phone: {{shop.phone}}</p> </div> </footer> <!-- Contact page content --> <div class="contact-content"> {{&shop.contact_text}} </div> Available Properties Property Description Example shop.nameYour store’s name "My Awesome Store"shop.urlYour store’s URL "https://mystore.com"shop.addressStreet address "123 Main Street"shop.zipcodePostal code "12345"shop.cityCity name "Stockholm"shop.phonePhone number "+46 123 456 789"shop.contact_textContact page content HTML content
Currency Conversion If you have multiple currencies enabled, display a currency picker:
Currency Picker
Advanced Currency Picker
{{#shop.cconverter_active}} <form method="get" action="{{url_current}}" class="currency-selector"> <label for="currency">{{#lang}}Currency{{/lang}}:</label> <select name="currency" id="currency" onchange="this.form.submit()"> {{#shop.cconverter_currencies}} <option value="{{currency}}" {{#current}}selected{{/current}}> {{currency}} </option> {{/shop.cconverter_currencies}} </select> </form> {{/shop.cconverter_active}}
Currency Object Properties When looping through shop.cconverter_currencies:
Property Description currencyCurrency code (e.g., “SEK”, “EUR”, “USD”) currentBoolean - true if this is the currently selected currency
Multi-Language Support Display language options when multiple languages are configured:
Language Selector
Compact Language Switcher
{{#shop.app.languages}} <div class="language-selector"> <h4>{{#lang}}Choose Language{{/lang}}</h4> {{#shop.languages}} <a href="{{url}}" class="language-option"> <img src="{{#asset_flags}}{{id}}{{/asset_flags}}" alt="{{id}}" class="flag"> {{id}} </a> {{/shop.languages}} </div> {{/shop.app.languages}}
Language Object Properties When looping through shop.languages:
Property Description idLanguage identifier (e.g., “en”, “sv”, “no”) urlURL to switch to this language asset_flagsHelper to get flag image for this language
Tax Toggle If tax toggling is enabled, allow customers to switch between prices including/excluding tax:
Tax Toggle
Tax Status Display
{{#shop.taxtoggle_active}} <div class="tax-toggle"> {{#shop.exclude_tax}} <a href="{{shop.incl_tax_url}}" class="tax-link" title="{{#lang}}Prices are excluding tax. Click to toggle{{/lang}}"> {{#lang}}Tax Excl.{{/lang}} </a> {{/shop.exclude_tax}} {{^shop.exclude_tax}} <a href="{{shop.excl_tax_url}}" class="tax-link" title="{{#lang}}Prices are including tax. Click to toggle{{/lang}}"> {{#lang}}Tax Incl.{{/lang}} </a> {{/shop.exclude_tax}} </div> {{/shop.taxtoggle_active}}
Property Description shop.taxtoggle_activeBoolean - true if tax toggle is enabled shop.exclude_taxBoolean - true if currently showing prices excluding tax shop.incl_tax_urlURL to switch to prices including tax shop.excl_tax_urlURL to switch to prices excluding tax
Customer Login Integration Display login/account links when customer accounts are enabled:
Login/Account Links
Header Account Menu
{{#shop.login_active}} <div class="account-links"> {{#user.logged_in}} <a href="{{user.login_url}}" class="account-link"> <i class="icon-user"></i> {{#lang}}My Account{{/lang}} </a> {{/user.logged_in}} {{^user.logged_in}} <a href="{{user.login_url}}" class="login-link"> <i class="icon-login"></i> {{#lang}}Log In{{/lang}} </a> {{/user.logged_in}} </div> {{/shop.login_active}}
Stock Messages Display custom out-of-stock messages:
<!-- Use custom sold out message if available --> {{#product.soldOut}} <div class="sold-out-notice"> {{#shop.soldout_text}} {{shop.soldout_text}} {{/shop.soldout_text}} {{^shop.soldout_text}} {{#lang}}Sorry, this item is currently out of stock{{/lang}} {{/shop.soldout_text}} </div> {{/product.soldOut}} Complete Examples <header class="store-header"> <!-- Main branding --> <div class="brand"> <h1><a href="{{shop.url}}">{{shop.name}}</a></h1> </div> <!-- Utility navigation --> <div class="header-utils"> <!-- Currency selector --> {{#shop.cconverter_active}} <div class="currency-selector"> <select name="currency" onchange="window.location=this.value"> {{#shop.cconverter_currencies}} <option value="{{url_current}}?currency={{currency}}" {{#current}}selected{{/current}}> {{currency}} </option> {{/shop.cconverter_currencies}} </select> </div> {{/shop.cconverter_active}} <!-- Language selector --> {{#shop.app.languages}} <div class="language-selector"> {{#shop.languages}} <a href="{{url}}" class="lang-link"> <img src="{{#asset_flags}}{{id}}{{/asset_flags}}" alt="{{id}}"> </a> {{/shop.languages}} </div> {{/shop.app.languages}} <!-- Tax toggle --> {{#shop.taxtoggle_active}} <div class="tax-toggle"> {{#shop.exclude_tax}} <a href="{{shop.incl_tax_url}}">{{#lang}}Incl. Tax{{/lang}}</a> {{/shop.exclude_tax}} {{^shop.exclude_tax}} <a href="{{shop.excl_tax_url}}">{{#lang}}Excl. Tax{{/lang}}</a> {{/shop.exclude_tax}} </div> {{/shop.taxtoggle_active}} <!-- Account links --> {{#shop.login_active}} <div class="account-links"> {{#user.logged_in}} <a href="{{user.login_url}}">{{#lang}}Account{{/lang}}</a> {{/user.logged_in}} {{^user.logged_in}} <a href="{{user.login_url}}">{{#lang}}Log In{{/lang}}</a> {{/user.logged_in}} </div> {{/shop.login_active}} </div> </header> <footer class="store-footer"> <div class="footer-content"> <!-- Store information --> <div class="footer-section"> <h3>{{shop.name}}</h3> {{#shop.address}} <div class="address"> <p>{{shop.address}}</p> <p>{{shop.zipcode}} {{shop.city}}</p> </div> {{/shop.address}} {{#shop.phone}} <div class="contact"> <p>{{#lang}}Phone{{/lang}}: {{shop.phone}}</p> </div> {{/shop.phone}} </div> <!-- Contact text --> {{#shop.contact_text}} <div class="footer-section"> <h3>{{#lang}}Contact{{/lang}}</h3> <div class="contact-text"> {{&shop.contact_text}} </div> </div> {{/shop.contact_text}} <!-- Currency and language options --> <div class="footer-section"> {{#shop.cconverter_active}} <div class="footer-currencies"> <h4>{{#lang}}Currency{{/lang}}</h4> {{#shop.cconverter_currencies}} <a href="{{url_current}}?currency={{currency}}" {{#current}}class="current"{{/current}}> {{currency}} </a> {{/shop.cconverter_currencies}} </div> {{/shop.cconverter_active}} {{#shop.app.languages}} <div class="footer-languages"> <h4>{{#lang}}Language{{/lang}}</h4> {{#shop.languages}} <a href="{{url}}">{{id}}</a> {{/shop.languages}} </div> {{/shop.app.languages}} </div> </div> </footer> Best Practices
Check Before Using Always check if features are enabled before displaying related UI elements (e.g., {{#shop.cconverter_active}})
Provide Fallbacks Provide fallback content when optional settings aren’t configured
Use Semantic HTML Structure your shop information with proper semantic HTML elements
Cache Considerations Shop data is cached and updates when you change store settings in the Control Panel
Next Steps 