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
Basic Store Information
Access your store’s core details that you’ve configured in the Control Panel:Available Properties
Property | Description | Example |
---|---|---|
shop.name | Your store’s name | "My Awesome Store" |
shop.url | Your store’s URL | "https://mystore.com" |
shop.address | Street address | "123 Main Street" |
shop.zipcode | Postal code | "12345" |
shop.city | City name | "Stockholm" |
shop.phone | Phone number | "+46 123 456 789" |
shop.contact_text | Contact page content | HTML content |
Currency Conversion
If you have multiple currencies enabled, display a currency picker:Currency Object Properties
When looping throughshop.cconverter_currencies
:
Property | Description |
---|---|
currency | Currency code (e.g., “SEK”, “EUR”, “USD”) |
current | Boolean - true if this is the currently selected currency |
Multi-Language Support
Display language options when multiple languages are configured:Language Object Properties
When looping throughshop.languages
:
Property | Description |
---|---|
id | Language identifier (e.g., “en”, “sv”, “no”) |
url | URL to switch to this language |
asset_flags | Helper to get flag image for this language |
Tax Toggle
If tax toggling is enabled, allow customers to switch between prices including/excluding tax:Tax-Related Properties
Property | Description |
---|---|
shop.taxtoggle_active | Boolean - true if tax toggle is enabled |
shop.exclude_tax | Boolean - true if currently showing prices excluding tax |
shop.incl_tax_url | URL to switch to prices including tax |
shop.excl_tax_url | URL to switch to prices excluding tax |
Customer Login Integration
Display login/account links when customer accounts are enabled:Stock Messages
Display custom out-of-stock messages:Complete Examples
Store Header with All Features
Store Footer with Contact Information
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