Bulk Importer & Exporter
Last updated: September 15, 2025
Please use caution with this tool. It is powerful and can directly influence the database of a site. For for more guidance or questions reach out to @fhme-engineers on Slack.
How to find the bulk importer & exporter:
- Under the Tools menu in the backend of a WordPress dashboard, there are two submenus called: Bulk Importer and Bulk Exporter
Bulk Exporter
The bulk exporter has the ability to export a csv of data from a specific FareHarbor Site in 2 different formats.
Posts’ SEO Export
- This type of export gets all relevant SEO data for pages, activities and blog posts. Can be useful for mass changing of SEO data (title tags, meta description, etc) for all posts on a site.
Global Find Export
- This type of export is based on the find value(s) a user supplies. Find value(s) are a comma separated list of words to find in the database. Place quotes around strings including commas.
- Example: (“Search, this thing”, search another thing). You then receive a csv of the instances found and their associated keys in the database. This can be useful for changing a word or phrase used multiple times on a site.
Bulk Importer
The bulk importer has the ability to import a csv of data into a specific FareHarbor Site in 2 different formats.
Posts’ SEO Import
- This type of import expects each row of the csv to represent one post. It is most useful for taking a Posts’ SEO Export, adding or updating the data, and then importing. This type of import can also be used to create new posts if the post_id column is left empty,
For this import do not edit the post_id or post_type columns. Note that editing the post_name column will change the slug for the associated post.
Find a template here.
SEO Import Note: Adding or Changing a post parent
To use an import to add parent pages for each post, add two columns with the headers post_parent and post_parent_type. For each row, in the first column, add the post id of the page you would like to assign as the parent. You can find the post id by visiting that post in wp admin and taking the number following &post= in the url. in the second column, add the post type of the parent (activity or page).
SEO Import Note: Adding Taxonomy Terms
Using the SEO bulk importer to affect terms associated with posts can have unintended consequences if not used correctly. If you are unsure, consult an FH.me engineer before importing.
To add or change the taxonomy terms for each post, add a column for each taxonomy you want to edit with a header like taxonomy_slug_taxonomy_terms where ‘taxonomy_slug’ is replaced by the actual taxonomy slug. You can find the taxonomy slug by visiting the taxonomy in wp admin and getting the value between ?taxonomy= and the following &. ( For example, a taxonomy admin page with the path edit/wp-admin/edit-tags.php?taxonomy=location&post_type=activity would mean the taxonomy has the slug location, and the column header to edit this taxonomies terms would be location_taxonomy_terms. ) If dashes are used, convert them to underscores.
Once you have a column created with the correct header, you can add a comma separated list of terms to add to the post. This list will REPLACE any previous term list instead of adding to the existing terms. If there are terms you would like to keep on the post, they must be included in the list in your import file.
The best way to import terms, is by using their ids. This means you should create all the terms you want in wp admin ahead of the import, and then you can find their ids by getting the value between &tag_ID= and the following &.
IF a taxonomy is not hierarchical, you may use the name of the term in the comma separated list, and new terms will be created if they do not match existing ones. Default taxonomies for blogs and cards ARE hierarchical and this does not apply. For activities, this is a setting on the taxonomy repeater in activity settings.
SEO Import Note: Importing Lists
To import to a field that has multiple values or a list, you can add a comma separated list in the appropriate import column. For example, to add multiple posts to the related_activities field of an activity, you can use a comma separated list of the desired activity post ids.
The list below are the fields that will accept a comma separated list to add multiple values:
related_activities – Yes there is only one right now!
If you would like to add multiple values to another field, submit an idea box!
Global Replace Import
- This type of import expects each row of the csv to represent one piece of data to go into the database. It is most useful for taking a Global Find Export, editing the data, and then importing.
- Example: Client changes their company name – we can export a CSV referencing all the pages that have the company name. Change the company name on the CSV to the new company, and import the updated CSV. The website now shows the new company name replacing everywhere the old company name was displayed.
For this import ONLY edit the value column. Editing other columns can result in unwanted or unexpected changes.
Find a template here.
How to Import the Presweep using Bulk Importer
To view the instructional video on importing the presweep, please view this Importing the Presweep help document. This presweep import process is new as of September 2025.