How to import listings
If you already have listings, the Import button appears below the listings table on the front-end account Listings page. If no listings exist yet, the Import Listings link is available in the user account menu.
By default, only administrators can import listings. You can allow regular users to import listings by enabling the corresponding option in HivePress > Settings > Listings > Submission.
Currently, only CSV files are supported for importing listings. If you don’t already have a CSV file with values that match the listing fields on your site, you can create one using Google Sheets or any other software that supports exporting to CSV.
The CSV file should use the first row for field labels, with each subsequent row containing the values for a single listing. You can also refer to this sample CSV file created for the ListingHive demo content.
Once your CSV file is ready, you can start the import process. In the first step, you can:
- Select the CSV file;
- Change the CSV delimiter (if it differs from a comma);
- Choose the import mode (create new listings or update existing ones);
- Select a specific category.
If you choose to update existing listings instead of creating new ones, the CSV file must include a column containing listing IDs that match those of existing listings on your site.
In the next step, you can map listing fields to the corresponding columns in the CSV file. Each field includes a hint indicating the valid value format.
For selectable field types (such as Select, Radio, Checkboxes), the imported values must exactly match the option labels (for example, category names for the Category field).
If you use the Geolocation extension and want to import location data, you need to include three separate CSV columns: the location text, latitude, and longitude.
On the last step, the listings are imported. The total number of imported listings is displayed, along with any validation errors that occurred during the import.