Add multiple locations in Apple Business
Create all your locations at once in Apple Business so your customers can find you wherever you have a location. If you already have existing locations, see Add an existing single location.
Overview
You can use a locations template file to upload all of your locations, including specific location information for each location. The file can contain locations from multiple brands and existing locations can be updated in bulk.
You can also edit multiple locations, for example, if each location changes their hours of operation. See Edit or remove multiple locations.
Requirements
Your organization needs to be verified with Apple. See Verify your organization.
You need to add a brand before you can add multiple locations. See Add a brand.
Any user whose role has permissions to manage locations can add multiple locations.
The maximum number of rows in a single file can’t be more than 10,000 rows.
Get started
Review these steps, then follow the tasks below this list to add multiple locations.
Step 1: Sign in and download the add multiple locations template .tsv file (located in the ZIP file, see About the ZIP file).
Step 2: Review the column headers and cell requirements for each location.
Step 3: Add the information for each location. Make sure you add all required information for each location.
Step 4: Save the file, then upload the file to Apple Business. If you have errors, fix them, then upload the file again.
Step 5: Send the file to Apple to review and approve the locations’ information.
Step 6: Review and fix any errors or warnings that Apple Business reports back to you.
Step 7: If necessary, review each location again and update any attributes that have a warning message.
About the ZIP file
The ZIP file contains one file and one folder:
A tab-delimited value
.tsvtemplate file pre-filled with your brand details.The folder contains the following files:
An example
.tsvfile that shows sample values for how to fill out the template accuratelyReference files for the following:
Valid category values.
Valid “Good to Know” values.
The meaning of each error code and the suggested corrective action.
Step 1: Download the add multiple locations template file
In Apple Business, sign in with a user whose role has permissions to manage locations.
To view roles and permissions, see Intro to roles and permissions.
In your browser, choose Brands > Locations.
Do one of the following:
If you have already created at least one location: Select Manage > Add Multiple Locations.
If you have not created any locations yet: Select Add Location > Add Multiple Locations.
Select Next.
Select Download Template (ZIP) to download the compressed file.
The ZIP file contains several files. See About the ZIP file.
Step 2: Review the locations template and reference files
Review the locations template requirements and best practices.
Review the categories reference file.
Review the “Good to Know” reference file.
Step 3: Add the information for each location
Gather the information from each location and add it to the template file.
Important:
Copy the correct Brand Reference ID and Brand ID in front of each location row. This ensures the location will be added to the brand correctly on Apple Business.
Make sure to check for any spelling errors in street names, city names, and other location information, which may cause errors (for example, an unapproved location) or customer confusion when finding your location.
Review the add multiple locations template.
Step 4: Save and upload the file
Save the file in one of the following formats.
Comma-separated value (
.csv)Tab-separated value (
.tsv)Microsoft Excel spreadsheet (
.xlsx)
Choose one of the following:
Drag the file to the Upload file area.
Select Upload file, then navigate to the folder containing the file you want to upload.
Important: Don’t leave or refresh the webpage until Apple finishes processing the file.
Do one of the following:
If you do have errors, you need to fix them, then upload the file again. Apple Business can’t process a file with errors.
If you didn’t have any errors in your file, you’ll see the total number of locations submitted for review.
When the processing is complete, proceed to step 5.
Step 5: Send the file to Apple to review and approve the locations’ information
Select Send for Review.
This process can take up to five business days.
View the banner that confirms the number of locations in the file and the expected time to complete the processing.
The user who submitted the file will receive two emails:
The first email confirms the file has been successfully submitted.
The second email confirms the final processing status; that the locations have been added or detailing any errors that need correction.
Step 6: Review and fix any errors or warnings
After you successfully submit your locations file, you can review the progress in the Activity section of Apple Business. After its processed by Apple, you can also download a report. Each file you submit shows the following:
Operation Name: This includes your uploaded file name.
Status: Displays either In Progress or Completed.
Dates: Displays either the date created or the date updated.
About the locations report file
The report contains the original information you submitted for the location rows with any potential issues and three columns added at the beginning of the report:
Column title | Values | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Status | Warning: The location created with warnings. Error: The location isn’t created. | ||||||||||
Error | If there are errors, the codes appear for the row separated by a comma. | ||||||||||
Warning | If there are warnings, the codes appear for the row separated by a comma. | ||||||||||
In Apple Business, sign in with a user whose role is Organization Administrator or the user who submitted the file.
To view roles and permissions, see Intro to roles and permissions.
Search for and select Reviewing new locations from [Name of your file].
Select the activity to view the following:
The current number of locations successfully processed.
The number of any potential issues.
A report.
Select Download Error Report, then save and open the file.
Review and fix any errors or warnings shown in the report in your original file.
Optional: Remove the first three columns (Status, Error, and Warning), then save the file.
Select Upload Corrected Report, then choose one of the following:
Drag the file to the Upload file area.
Select Upload file, then navigate to the folder containing the file you want to upload.
Do one of the following:
If you do have errors, you need to fix them, then upload the file again. Apple Business can’t process a file with errors.
If the file contains more than five errors, you can download all the errors in the .txt file, so you can fix them offline before you upload the file again.
If you didn’t have any errors in your file, you’ll see the total number of locations submitted for review.
Select Send for Review to send the file to Apple to review and approve the locations’ information.
This process can take up to five business days.
Step 7: If necessary, review each location again and update any attributes that have a warning message
Scroll through your location list to locate any location with a warning message about incorrect attributes.
Select a location, then edit the attributes with a warning.
Save the changes.
Repeat this task until there are no warnings in any locations.