Insites Docs Instance LocatorLocationsImporting and Exporting Locations in the Locator

Importing and Exporting Locations in the Locator

Last updated on January 09, 2025.

Insites enables you to import locations into the locator and export them to an external system. Topics in this article include the following:

  • Importing locations
  • Exporting locations

Importing locations

You can bulk import location data using comma-separated value (CSV) files to your locator. This capability allows you to pass data from an external system not integrated with Insites without manually entering the data into the database using your application's fields and forms.

Important

The functionality can process and upload 5000 items simultaneously. If your CSV file contains more than 5000 items, please split it into multiple parts so that the data can be uploaded to your Instance.

To import data onto the locator:

  1. Navigate to the Locator on the main menu.
  2. Select Locations.
  3. Select the overflow menu (), then select Import Locations.
  4. Select the CSV Template link on the 'Import Locations' drawer to download the CSV template.
  5. Use the CSV template as a guide for creating an import file that matches the input requirements in Insites.
  6. When your CSV file is ready, return to the 'Import Locations' drawer by executing steps #1 - #3.
  7. Drag and drop your file, or use the clickable area on the drawer to upload your CSV file.
  8. Select IMPORT LOCATIONS.

The following table displays the input requirements and descriptions for importing locations into the locator:

Column LabelTypeRequiredDescription
UUID String Yes Universal Unique Identifier (UUID) of the location.
Location Name String No Name of the location.
Category UUID String No Universal Unique Identifier (UUID) of the category of the location.
Status String No

Status of the location. Options include the following:

  • enabled
  • disabled
  • archived
Slug String No Uniform Resource Locator (URL) slug for this location.
Start Date String No The date when the location was added to the web application.
End Date String No The date when the location is no longer displayed on the web application.
Short Description String No Short description of the location.
Long Description String No Lengthy, more detailed description of the location.
Address 1 String No Line 1 of the address for the location.
Address 2 String No Line 2 of the address for the location.
Address 3 String No Line 3 of the address for the location.
City String No The city where the address is located.
County String No The county where the address is located.
District String No The district where the address is located.
Suburb String No The suburb where the address is located.
State String No The state or region where the address is located.
Country String No The country of the location.
Country Code String No Country code of the location.
Postcode String No Postal code of the location.
Latitude String No Latitude of the location.
Longitude String No Longitude of the location.
Geojson String No GeoJSON snippet of the location.
Phone Number String No The location's phone number.
Phone Country Code String No Country code of the location's phone number.
Fax Number String No The location's fax number.
Fax Country Code String No Country code of the location's fax number.
Email String No The location's email address.
Facebook Link String No Link to the location's Facebook profile or page.
Twitter Link String No Link to the location's X (formerly Twitter) link.
Youtube Link String No Link to the location's YouTube channel.
Linkedin Link String No Link to the location's LinkedIn page.
Instagram Link String No Link to the location's Instagram profile.
Snapchat Link String No Link to the location's Snapchat.
Social 1_Link String No Link to the location's other social media account.
Social 2_Link String No Link to the location's other social media account.
Is Open On Monday Boolean No

Indicates if the location is open on Monday. Options include:

  • TRUE
  • FALSE
Monday Opening Time String No The opening time of the location on Monday.
Monday Closing Time String No The closing time of the location on Monday.
Monday Notes String No Notes regarding the location's Monday opening and closing hours.
Is Open On Tuesday Boolean No

Indicates if the location is open on Tuesday. Options include the following:

  • TRUE
  • FALSE
Tuesday Opening Time String No The opening time of the location on Tuesday.
Tuesday Closing Time String No The closing time of the location on Tuesday.
Tuesday Notes String No Notes regarding the location's Tuesday opening and closing hours.
Is Open On Wednesday Boolean No

Indicates if the location is open on Wednesday. Options include the following:

  • TRUE
  • FALSE
Wednesday Opening Time String No The opening time of the location on Wednesday.
Wednesday Closing Time String No The closing time of the location on Wednesday.
Wednesday Notes String No Notes regarding the location's Wednesday opening and closing hours.
Is Open On Thursday Boolean No

Indicates if the location is open on Thursday. Options include the following:

  • TRUE
  • FALSE
Thursday Opening Time String No The opening time of the location on Thursday.
Thursday Closing Time String No The closing time of the location on Thursday.
Thursday Notes String No Notes regarding the location's Thursday opening and closing hours.
Is Open On Friday Boolean No

Indicates if the location is open on Friday. Options include the following:

  • TRUE
  • FALSE
Friday Opening Time String No The opening time of the location on Friday.
Friday Closing Time String No The closing time of the location on Friday.
Friday Notes String No Notes regarding the location's Friday opening and closing hours.
Is Open On Saturday Boolean No

Indicates if the location is open on Saturday. Options include the following:

  • TRUE
  • FALSE
Saturday Opening Time String No The opening time of the location on Saturday.
Saturday Closing Time String No The closing time of the location on Saturday.
Saturday Notes String No Notes regarding the location's Saturday opening and closing hours.
Is Open On Sunday Boolean No

Indicates if the location is open on Sunday. Options include the following:

  • TRUE
  • FALSE
Sunday Opening Time String No The opening time of the location on Sunday.
Sunday Closing Time String No The closing time of the location on Sunday.
Sunday Notes String No Notes regarding the location's Sunday opening and closing hours.
Is Sitemap Enabled Boolean No

Include or exclude this location page from the system-generated XML sitemap. Input options include the following:

  • TRUE
  • FALSE
Sitemap Priority Float No The priority of this URL relative to other URLs on the site. Valid values range from 0.0 to 1.0. URLs are sorted in descending order.
Sitemap Order Number No The order of the URL in relation to other URLs if they have the same priority value. URLs with the same priority values are sorted in ascending order.
Sitemap Change Frequency String No

Sets how often search engine bots crawl your page to check for updates. Some values are:

  • Always
  • Daily
  • Monthly
  • Never

Note that crawlers treat the values chosen as a 'hint,' not a 'command.' For example, crawlers may crawl pages marked 'hourly' less frequently.
Is Visible To Search Engines Boolean No

Indicates if the page is visible or hidden from search engines. Input options include the following:

  • TRUE
  • FALSE
Canonical URL String No A canonical URL used to prevent duplicate content issues in SEO.
Meta Title String No Meta title of the page. A good title has between 40 - 60 characters.
Meta Description String No Meta description of the page. A good meta description has between 150 - 160 characters.
Open Graph Title String No Open Graph title of the location. The field is only editable if 'Use Meta Title As Open Graph Title' is disabled.
Open Graph Description String No The Open Graph description of your location. The field is editable only if 'Use Meta Description As Open Graph Description' is disabled. This 1 - 2 sentence snippet is displayed in the post and can mean the difference between getting clicks or not.
Open Graph URL String No Open Graph URL (link) associated with your content.
Open Graph Site Name String No The TAG og:site_name meta tag used to specify the name of the website where the location is hosted.
Open Graph Type String No Type of content, i.e., website, article, and blog.
Schema Content String No The schema markup for the location.
System Field UUIDs Array No Universal Unique Identifiers (UUID) of the system fields used by the location.
Is FAQs Displayed Boolean No

Show or hide the FAQ section. Options include the following: Input options include the following:

  • TRUE
  • FALSE
FAQs Section Heading String No Title of the FAQ section.
FAQs Section Subheading String No Subheading of the FAQ section.
FAQs Array No Array of FAQ items for the location. Each array element contains:
[
  {"uuid":"<FAQ item UUID>,"question":"<input question>",
  "answer":"<p>FAQ answer</p>"},
  . . . 
  . . .
  { . . . }
]
Note

Please take note of the following system behaviors:

  • To ADD a location: Leave the 'ID' column empty on the CSV file. A new location will be created and assigned a new and unique ID.
  • To UPDATE a location: Provide the ID of an existing product on the CSV file. Providing an ID that does not exist will cause an error.

Exporting locations

To export locations:

  1. Navigate to the Locator from the main menu.
  2. Select Locations.
  3. Select the overflow menu (), then select Export Locations.
Have a suggestion for this page?

Didn't quite find what you are looking for or have feedback on how we can make the content better then we would love to hear from you. Please provide us feedback and we will get back to you shortly.