{"title":"Change default street address layout","slug":"multi-line-street-address","url":"https://support.storeconnect.com/articles/multi-line-street-address","url_markdown":"https://support.storeconnect.com/articles/multi-line-street-address.md","subtitle":null,"summary":"Split the single street address field into multiple lines (suite, building number, etc.) by creating a store variable. Labels are customizable via theme translations.","type":"Help_Documentation","video_url":"","keywords":"multi-line street address, street address layout, address fields, checkout address, billing address, shipping address, store variable, visible_address_lines, address customization, suite apartment building number, theme translations, address validation","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"StoreConnect collects a customer shipping and billing addresses and saves these on each order in Salesforce. For new customers, these are also saved on the Account record.\nBy default, your store will provide a single field for Street Address and separate fields for City, State, Zip Code, and Country.\n\n#### Single-line street address\n\n![Single-line Street Address Field](https://res.cloudinary.com/hzkr6fi81/image/upload/v1781677792/documentation-media/multi-line-street-address/single-line-street-address.png)\n\nIf you need to separate street address into multiple parts, like Suite, Building Number, etc. you can split the street address field out into multiple fields.\n\n#### Multi-line street address\n\n![Multi-line Street Address Field](https://res.cloudinary.com/hzkr6fi81/image/upload/v1781677793/documentation-media/multi-line-street-address/multi-line-street-address.png)\n\nThe extra fields will be available on all pages where an address is rendered, like checkout or an account profile page.\n\nThe default labels that come with the extra fields are:\n\n1.  Street address\n2.  Suite\n3.  Apartment\n4.  Building Number\n5.  line 5\n6.  line 6, etc.\n\nThere is no limit on the number of rows other than Salesforce’s 255 character limit. Labels can be changed to anything you want using translations within the stores theme.\n\nEach field will display separately in your store but will all still be saved in the same street address fields in Salesforce but separated into multiple lines. This allows you to take each line and place each in your own custom fields in Salesforce to do with what you please. You could achieve this using an Apex trigger.\n\n#### Salesforce street address field with multi-line\n\n![Salesforce Street Address Field](https://res.cloudinary.com/hzkr6fi81/image/upload/v1781677794/documentation-media/multi-line-street-address/salesforce-street-field.png)\n\n:::note\nSalesforce will remove any blank lines at the beginning of it’s fields so the first line must always contain a value. Your customers will be prompted to enter a value in Street Address Line 1 if they leave it blank.\n:::\n\n### Address validation\n\nIf you want to add address validation to your store to prevent typos causing packages being set to the wrong place, Check out [Addressfinder](https://addressfinder.com.au/). These guys have a great solution that works on single line and multi-line street addresses.\n\n## How to enable multi-line street address\n\n1.  From your Store record, find the Store Variables related list\n2.  Create a new Store Variable\n3.  Give it a name\n4.  Use this Key: `visible_address_lines`\n5.  Set the Value to how many lines you want to show in place of the single Street Address line (Integer eg. 1-9)\n6.  Click ‘Save’\n\nYour new fields will now show for this store.\n\n![Multi-line Street Address Config](https://res.cloudinary.com/hzkr6fi81/image/upload/v1781677795/documentation-media/multi-line-street-address/street-address-store-variable.png)\n\nTo change the labels for your new fields, you will need to add translations to your store’s theme. You will find instructions on [Theme locales](theme-locales) under ‘Locales’.\n\nThe translation keys are as follows:\n\n-   Line 1: `accounts.shared.address_form.address_lines.count.#1`\n-   Line 2: `accounts.shared.address_form.address_lines.count.#2`\n-   Line 3: `accounts.shared.address_form.address_lines.count.#3`, etc."}