BoardScribe makes it easy to add multiple meetings to your WordPress website at once using a CSV file. This is especially helpful when setting up BoardScribe for the first time, migrating meeting records from another system, or adding historical meeting information.
Instead of creating each meeting individually, you can prepare a spreadsheet with your meeting information and import all meetings in a single upload.
Before You Begin
To import meetings, you’ll need a CSV file containing your meeting information.
You can create this file using Microsoft Excel, Google Sheets, or another spreadsheet application.
Each row in your spreadsheet represents one meeting, and each column represents a specific piece of meeting information, such as the meeting title, date, or agenda URL.
Important things to know:
- The first row of your CSV file must contain column headers.
- The
datecolumn is required for every meeting. - All other columns are optional.
- Column headers must match the supported field names listed below.
- You can leave optional fields blank if the information is unavailable.
- BoardScribe Pro supports importing additional fields for meeting locations, recordings, supporting documents, and categories.
Step 1: Prepare Your CSV File
Create a new spreadsheet and add the appropriate column headers in the first row, then fill in your data as necessary.
Supported CSV fields: BoardScribe Free
The following fields are supported in BoardScribe Free.
| Column Title | Required | Description |
|---|---|---|
title |
No | Meeting title. If blank, BoardScribe automatically generates a title based on the meeting date, such as “Board Meeting – March 15, 2025”. |
date |
Yes | Meeting date in YYYY-MM-DD format. |
start_time |
No | Meeting start time, such as 17:00, 5:00 PM, or 5pm. |
end_time |
No | Meeting end time. Accepts the same formats as start_time. |
agenda_url |
No | Full URL to the meeting agenda file. |
minutes_url |
No | Full URL to the meeting minutes file. |
not_held |
No | Indicates that a meeting was not held. Accepted values are yes, 1, or true. Leave blank if the meeting was held. |
publish_date |
No | Sets the WordPress publication date independently of the meeting date. |
Additional supported CSV fields: BoardScribe Pro
BoardScribe Pro supports additional meeting data, such as categories, additional documents, links, and more. You can include the following data in your import file if you have an active BoardScribe Pro license.
| Column Title | Required | Description |
|---|---|---|
location_name |
No | Name of the meeting location. If a published location with the same name already exists (case-insensitive), the meeting is linked to that location and the other location_* fields are ignored. Otherwise, a new location is created using the additional location fields. |
location_type |
No | Type of meeting location. Accepted values are in_person, virtual, or hybrid. Only used when creating a new location. |
location_room |
No | Room or area where the meeting takes place. Only used when creating a new location. |
location_address_1 |
No | First line of the meeting location’s street address. Only used when creating a new location. |
location_address_2 |
No | Second line of the meeting location’s address, such as a suite or building number. Only used when creating a new location. |
location_city |
No | City where the meeting location is located. Only used when creating a new location. |
location_state |
No | State or province of the meeting location. Only used when creating a new location. |
location_zip |
No | ZIP or postal code of the meeting location. Only used when creating a new location. |
location_country |
No | Country of the meeting location. Defaults to United States if not specified. Only used when creating a new location. |
location_instructions |
No | Public instructions for attending the meeting, such as parking information, building entrances, or accessibility details. Only used when creating a new location. |
location_phone |
No | Phone number associated with the meeting location. Only used when creating a new location. |
location_email |
No | Email address associated with the meeting location. Only used when creating a new location. |
location_meeting_link |
No | Link to join a virtual meeting. Must begin with http:// or https://. Invalid URLs are not saved. Only used when creating a new location. |
livestream_url |
No | Full URL to the meeting livestream. Must begin with http:// or https://. Invalid URLs are not saved. |
recording_url |
No | Full URL to the meeting recording. Must begin with http:// or https://. Invalid URLs are not saved. |
cc_transcript_url |
No | Full URL to the meeting’s closed captions transcript file. Must begin with http:// or https://. Invalid URLs are not saved. |
documents |
No | Additional supporting documents. Enter each document as a label and URL separated by a pipe character (|). Separate multiple documents with semicolons. For example: Budget|https://example.com/budget.pdf; Report|https://example.com/report.pdf. |
date_display_override |
No | Custom text to display instead of the automatically formatted meeting date, such as “March Special” or “TBD”. Does not affect sorting; the date column still determines the meeting’s chronological order. |
category |
No | Meeting category name or slug. If the category does not already exist, it is automatically created. |
Formatting dates and times
Meeting dates must use the YYYY-MM-DD format.
For example, November 10, 2026, should be entered as 2026-11-10.
Meeting start and end times can use several common formats, including:
17:005:00 PM5pm
If BoardScribe cannot recognize a meeting time, it will still import the meeting, but it won’t save the invalid time.
Adding document URLs
To associate an agenda, minutes, or other supported document with a meeting, enter the full URL of the file in the appropriate column.
For example:
https://example.org/wp-content/uploads/2026/11/board-agenda.pdf
URLs must begin with http:// or https://. Invalid URLs will not be saved.
You can leave document fields blank for meetings that do not yet have documents available.
Note: BoardScribe will not download and import PDFs into the WordPress media library. URLs will be maintained as-is.
Meeting dates vs. publication dates
BoardScribe distinguishes between the meeting date and the date its WordPress post is published.
The date field controls the meeting date and meeting sort order.
The publish_date field controls the actual WordPress publication date.
For example, suppose you’re importing a board meeting that occurred on March 15, 2024, but you’re importing it into WordPress in October 2026.
You could use:
date:2024-03-15publish_date:2024-02-15 14:30:00
This sets the original WordPress publication date to 30 days before the meeting instead of the day you ran the import. This is especially helpful if you are required to publish public notice of meetings a certain number of days before the start of the meeting, and are importing meetings from another system; you can set the publish_date to match the date you originally published the meeting in your previous system.
The publish_date field accepts recognizable date and date/time formats, including:
- Year-Month-Day:
2024-03-15 - Year-Month-Day with timestamp:
2024-03-15 14:30:00 - ISO 8601 extended date-time format with a UTC offset:
2024-03-15T14:30:00-05:00
Important: If you specify a future publish_date, WordPress schedules the meeting for publication at that time. The meeting will not appear publicly on your website until its scheduled publication date.
Example data
For a basic import, you might use these columns:
| title | date | start_time | end_time | agenda_url |
|---|---|---|---|---|
| Regular Board Meeting | 2026-11-10 | 5:00 PM | 7:00 PM | https://example.org/agenda.pdf |
| Budget Committee Meeting | 2026-11-17 | 10:00 AM | 11:30 AM | |
| Special Board Meeting | 2026-12-01 | 6:00 PM |
You only need to include columns that contain information you want to import, except for the required date column.
Step 2: Export Your Spreadsheet as a CSV
After you enter your meeting information in your spreadsheet, save or download the spreadsheet as a CSV file.
In Google Sheets:
- Open the spreadsheet.
- Select File > Download > Comma Separated Values (.csv).
- Save the file to your computer.
In Microsoft Excel:
- Open the spreadsheet.
- Select File > Save As.
- Choose CSV UTF-8 (Comma delimited) as the file format.
- Save the file to your computer.
Step 3: Upload Your CSV to BoardScribe
- Log in to your WordPress admin dashboard.
- Open the BoardScribe meeting import screen (Board Meetings > Settings > Import).
- Click the file selection button under Upload CSV.
- Select the CSV file you prepared.
- Click the “Import Meetings” button to begin importing your meetings.
Each valid row creates a meeting in WordPress, unless BoardScribe identifies it as a duplicate of an existing meeting.
After importing, review your meetings in WordPress to confirm that their information appears as expected.
Additional CSV Fields: BoardScribe Pro
BoardScribe Pro supports all the free version fields, plus additional information for meeting locations, virtual attendance, recordings, documents, and categories, as noted above. Here’s additional information about BoardScribe Pro fields.
Meeting locations
BoardScribe Pro allows you to associate meetings with locations and create new locations during import.
| Column Title | Description |
|---|---|
location_name | Name of the meeting location. Used to match an existing location or create a new one. |
location_type | Type of location: in_person, virtual, or hybrid. |
location_room | Specific room or area where the meeting takes place. |
location_address_1 | Street address, line 1. |
location_address_2 | Street address, line 2. |
location_city | City. |
location_state | State or province. |
location_zip | ZIP or postal code. |
location_country | Country. Defaults to United States. |
location_instructions | Public instructions, such as parking information, entrance directions, or accessibility details. |
location_phone | Location phone number. |
location_email | Location email address. |
location_meeting_link | Full URL to a virtual meeting. |
All location fields are optional.
How location matching works
When you provide a location_name, BoardScribe checks whether a published location with that name already exists.
- If a matching location exists: The meeting is linked to that location. The remaining
location_*fields in the CSV are ignored. - If no matching location exists: BoardScribe creates a new location using the information supplied in the CSV.
Location name matching is case-insensitive. For example, City Hall and city hall are considered matches.
This allows you to reuse the same location across multiple meetings without creating duplicate location records.
Tip: Use consistent location names throughout your CSV. If several meetings take place at City Hall, enter the same location_name for each one.
If you need to change an existing location’s address, meeting link, or other details, edit the location directly in WordPress rather than attempting to update it through another meeting import.
Livestreams, recordings, and transcripts
BoardScribe Pro also supports links to meeting video and transcript resources.
| Column Title | Description |
|---|---|
livestream_url | Full URL where the meeting will be livestreamed. |
recording_url | Full URL to a recording of the meeting. |
cc_transcript_url | Full URL to a closed captions transcript file. |
Each URL must begin with http:// or https://.
Invalid URLs will not be saved.
Supporting documents
In addition to agenda and minutes files, BoardScribe Pro allows you to import additional supporting documents using the documents column.
Each document must be entered as a label and URL separated by a vertical bar or pipe (|).
For example:
Budget|https://example.org/budget.pdf
To add multiple documents to one meeting, separate each label-and-URL pair with a semicolon.
For example:
Budget|https://example.org/budget.pdf; Annual Report|https://example.org/report.pdf
This example associates two supporting documents with the meeting: one labeled “Budget” and another labeled “Annual Report.”
When working in a spreadsheet, keep all supporting documents for a meeting in the same documents cell.
Meeting date display override
The optional date_display_override field lets you replace the automatically formatted meeting date with custom text.
For example, you might enter:
March SpecialTBD
When this field is populated, BoardScribe displays the custom text instead of the computed meeting date.
Important: The date column is still required. The date display override changes only the displayed text, not the actual meeting date or sort order.
Meeting categories
Use the category column to assign a meeting to a category.
You can enter either the category name or its slug. If the category does not already exist, BoardScribe creates it during the import.
For example, you could categorize meetings as:
- Board Meetings
- Budget Committee
- Special Meetings
- Executive Committee
Categories can be used to filter which meetings show in BoardScribe blocks and shortcode output.
Frequently Asked Questions
Can I import meetings without a title?
Yes. If the title column is blank, BoardScribe automatically creates a meeting title based on the date.
Can I import meetings without an agenda or minutes?
Yes. Agenda and minutes URLs are optional. You can import meetings without these files and add them later in WordPress.
Can I import historical meetings?
Yes. Use the date column to specify when each meeting occurred. You can also use publish_date to preserve historical WordPress publication dates.
Can I import future meetings?
Yes. You can specify future meeting dates. If you also set a future publish_date, WordPress will schedule the meeting’s publication for that date and time.
What happens if a URL is invalid?
BoardScribe does not save invalid URLs in URL fields that require full HTTP or HTTPS addresses. However, BoardScribe does not load URLs to check whether the linked file exists or is publicly accessible. If you have a typo in your URL or your file-sharing settings for a Google- or Microsoft-hosted document aren’t set to public, people may be blocked from viewing your documents when they click the link. Always test your URLs as a logged-out user or in an incognito browser before running your import.
What happens if my meeting time is invalid?
If BoardScribe cannot recognize the start time, it still imports the meeting, but it doesn’t save a start time.
Can I create meeting locations during import?
Yes, with BoardScribe Pro. Provide a location_name and any additional location information. BoardScribe links to an existing published location with a matching name or creates a new location.
Can I add multiple supporting documents to one meeting?
Yes, with BoardScribe Pro. Use the documents column and separate each document’s label and URL with a vertical bar. Separate multiple documents with semicolons.
Will importing the same file twice create duplicate meetings?
Normally, no. BoardScribe skips rows that match existing meetings according to its duplicate detection rules. However, if you change an imported meeting’s identifying information in WordPress, importing the original file again may create a new meeting.
How does duplicate detection work?
BoardScribe includes duplicate detection to help prevent accidentally creating duplicate meetings. This is useful if you upload a file and later accidentally upload it again.
BoardScribe compares imported meetings against the meeting information currently saved in WordPress.
The matching rules depend on whether the imported row includes a start time.
When the CSV row includes a start time:
A meeting is considered a duplicate when an existing meeting has:
- The same title.
- The same meeting date.
- Either the same start time or no saved start time.
When the CSV row does not include a start time:
A meeting is considered a duplicate when an existing meeting has the same title and date, regardless of its saved start time.
Matching rows are skipped rather than imported again.
What happens if you edit an imported meeting and import the file again?
Duplicate detection uses the meeting’s current saved information, not the original CSV values.
For example, suppose you import a meeting titled “Regular Board Meeting” for November 10, 2026.
Later, you change its title in WordPress to “November Board Meeting.”
If you upload the original CSV again, BoardScribe will no longer find a matching meeting with the original title and date. It may create another meeting. The same applies if you change the meeting date or change its start time when the CSV row includes a start time.
Can I update existing meetings by re-importing a CSV?
No. CSV importing is designed to create meetings, not update existing ones.
If a meeting already exists and matches the duplicate detection rules, the imported row is skipped.
For example, if you initially imported a meeting without a start time and later added a start time to your CSV, re-importing the file will not add that time to the existing meeting.
Edit existing meetings directly in WordPress to change their details, or you can delete all meetings and run your import again.