Review the add multiple locations template in Apple Business
You use the add multiple locations template to upload all your locations and their important information. To make changes to location information after you upload the original file, see Edit or remove multiple locations.
To download the template, see Download the add multiple locations template file.
Overview
There are three main content types:
Required: This content is required for the location.
Optional: This content may be added for the location.
Conditional: This content might be required depending on whether optional content is added.
The following location content can’t be added to the template file:
Organization logo
Cover photo
Showcases
Action links (To add Action links for your locations, see About Actions.)
Photos
Alternative/Additional Name
Alternative About Description
Service Hours
Temporary Hours
App Store URL
Best practices
Use the included reference files to find the correct values for Categories and “Good to Know” attributes that best represent your locations.
View the example file to understand the correct formatting for each attribute.
Don’t delete any columns from the template. Rows may be removed if you don’t need to add more locations.
Note: The file structure and column headers are in U.S. English regardless of the preferred language you set in Apple Business. You can add your preferred language in the dedicated language columns for Display Name and About Location.
Add locations template content list
Content category | Type / Character limits | Description | Example | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Brand Reference ID | Required: Yes Character limit: NA | The Brand Reference ID is a unique identifier combining your brand name and country. When you add locations to a specific brand, ensure the Brand Reference ID and Brand ID remain exactly as provided in the downloaded template Important: Don’t modify them. Copy both values into every row for each new location you add. | Melard_US | ||||||||
Brand ID | Required: Yes Character limit: NA | The Brand ID is a unique identifier. When you add locations to a specific brand, ensure the Brand Reference ID and Brand ID remain exactly as provided in the downloaded template Important: Don’t modify them. Copy both values into every row for each new location you add. | 12345678901234567890 | ||||||||
Display Name | Required: Yes Character limit: 255 | Needs to match the display name. | Melard Clothing | ||||||||
Display Name Language | Required: Yes Character limit: 5 | Needs to be the language code. See Language list. | en-US | ||||||||
About Location | Required: No Character limit: 500 | A short, customer-facing description that tells Apple and your customers about this location. For example, what it’s known for, its specialties, history, or notable features. See Add an “about”. | Melard Clothing is a vintage clothing store for everyone that opened in Cupertino in 1992. | ||||||||
About Location In Additional Language | Required: No Character limit: 500 | A translated version of the About Location content for regions with more than one commonly used language. | A Spanish translation of the About content for a location where Spanish may be an official optional language. The content needs to be identical across all languages. For example, Melard Clothing es una tienda de ropa vintage para todos que abrió en Cupertino en 1992. | ||||||||
Location Address Country Name | Required: Yes Character limit: 2 | The approved two-letter country code for the country of the location. | US | ||||||||
Address Line 1 | Required: Yes Character limit: 2-200 | The official street address of the location. | 123 Main Street | ||||||||
Address Line 2 | Required: No Character limit: 200 | A suite, floor, or unit number of the location. | Building 5 | ||||||||
Address City | Required: Yes Character limit: 255 | The full name of the city of the location (not an abbreviation). | Cupertino | ||||||||
Address State or Region | Conditional: On country or region requirements. Character limit: 255 | The full name of the state or region of the location. | United States: Needs to be the full name, for example, California. Can be empty only for countries where it’s not required. | ||||||||
Address Postal Code | Required: Yes Character limit: 10 | The postal code of the location. Note: Prepend an apostrophe (') before any postal code that starts with zero (0), for example, 01234. The apostrophe preserves the leading zero, for example '01234. | 95014 '01234 | ||||||||
Address Coordinates | Required: No Character limit 1: 2-3 numbers plus a comma Character limit 2: 5 decimal places also required | The longitude and latitude of the location, centered directly on the building. | 37.32496,122.01582 | ||||||||
Normal Hours | Required: Yes Character limit: See Example | Normal operating hours of the location. Normal Hours is a free-text field. You don’t need to follow a strict format, Apple interprets your input automatically. Be as clear as possible when entering hours. If Apple can’t interpret your input with sufficient confidence, your location will still be updated for all other fields but you’ll receive a warning in your processing report and you’ll need to update the hours manually in that location’s Info section in Apple Business. See Manage hours. | Mon-Fri 9am-5pm, Sat 10am-3pm, Sun closed | ||||||||
Phone Number | Required: Yes Character limit: 8-15 digits | The plus sign (+), country code ,and public phone number of the location. See Add a phone number. | +18885551212 | ||||||||
Website | Required: No Character limit: 255 | The URL of the location’s website, Facebook, Instagram, or Tik Tok page. Not permitted: Third-party websites not owned or operated by your organization’s brand. See Add a website. | https://www.melardclothing.com | ||||||||
Primary Category | Required: Yes Character limit: NA | The primary category of the location. See Add your category. | Clothing store | ||||||||
Additional Category | Required: No Character limit: NA Other: Maximum 3 additional | An optional secondary category of the location.You can provide up to three additional categories per location. See the category reference file that was downloaded in the ZIP file and Add your category. | Coffee shop | ||||||||
Good To Know | Required: No Character limit: NA Other: Maximum 10 additional | Attributes about the location, separated by a pipe (|). Only values associated with the primary category are permitted. See the “Good to Know” reference file that was downloaded in the ZIP file and Manage “Good to Know” attributes. | Wheelchair Accessible|Contactless Payments|Free Wi-Fi|Outdoor Seating | ||||||||
Status | Required: Yes Character limit: NA | Can be set to OPEN or OPENING_SOON. See Manage status. | OPEN | ||||||||
Opening Soon Date | Conditional: Required if Status is set to opening soon. Character limit: 10 Other: Needs to be in the ISO 8601 YYYY-MM-DD format. | The Opening Soon Date can be up to six months from the current date. | 2027-08-05 | ||||||||