{"title":"Outlet - Liquid Object Reference","slug":"outlet-liquid-object-reference","url":"https://support.storeconnect.com/articles/outlet-liquid-object-reference","url_markdown":"https://support.storeconnect.com/articles/outlet-liquid-object-reference.md","subtitle":null,"summary":"The Outlet object exposes a physical retail outlet to Liquid templates. It is available via current_outlet in POS contexts and exposes address, contact, register, and custom data fields.","type":"Developer_Documentation","video_url":"","keywords":"liquid, objects, Outlet, POS, current_outlet, template, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Description\n\nThe Outlet object exposes a physical retail outlet to Liquid templates. It is primarily available in POS contexts via `current_outlet`, where it drives sync scope, register selection, and store linking.\n\n:::note\n`current_outlet` is available in POS Liquid templates and sync scope filters only. It is not populated in web theme templates.\n:::\n\n## Attributes\n\n| Attribute | Type | Description |\n|-----------|------|-------------|\n| `address1` | String | First address line for this outlet |\n| `address2` | String | Second address line for this outlet |\n| `city` | String | City for this outlet |\n| `country` | Object | Country for this outlet. In POS, only `country.name` is available — `alpha2`, `alpha3`, and `states` are not yet supported on the device. |\n| `data` | Map | Custom data fields for this outlet. Access via field API name (e.g. `data.region__c`). |\n| `id` | String | Unique Salesforce ID (sfid) for this outlet |\n| `sfid` | String | **Deprecated** — use `id` instead |\n| `name` | String | Name of this outlet |\n| `phone` | String | Phone number for this outlet |\n| `register_code` | String | Register code for this outlet |\n| `registers` | Collection | Registers attached to this outlet. Each item is a [Register - Liquid Object Reference](register-liquid-object-reference) object. |\n| `state` | String | State for this outlet |\n| `store` | Object | The store this outlet belongs to |\n| `tax_number` | String | Tax number for this outlet |\n| `zip_code` | String | Zip/postal code for this outlet |\n\n## Custom data\n\nCustom fields defined on the Outlet Salesforce object are accessible via the `data` map using the field API name:\n\n\n```liquid\n\n{{ current_outlet.data.region__c }}\n{{ current_outlet.data.s_c__warehouse_id__c }}\n```\n\n\n## Usage\n\n\n```liquid\n\n{{ current_outlet.name }}\n{{ current_outlet.address1 }}, {{ current_outlet.city }} {{ current_outlet.state }} {{ current_outlet.zip_code }}\n\n{% for register in current_outlet.registers %}\n  {{ register.name }} ({{ register.id }})\n{% endfor %}\n\n{{ current_outlet.data.region__c }}\n```\n\n\n## Related\n\n- [Register - Liquid Object Reference](register-liquid-object-reference) — registers attached to this outlet\n- [Using global Liquid tags](liquid-how-to-global-tags) — global context variables including `current_outlet`\n\n## Available on\n\n- [Register - Liquid Object Reference](register-liquid-object-reference) — `outlet`"}