There are two ways to import guests into zkipster:

  • Importing via a CSV or XLSX file
  • Manually adding a guest

This article will cover how to import a spreadsheet file (XLSX or CSV format) into zkipster.

Watch our tutorial video for a quick overview:

Find step-by-step information in the sections below.

Important Information Before Uploading

Before importing your excel document into zkipster, we recommend checking out this article on Tips and FAQs on how to format your spreadsheet and errors to avoid when setting up your guest list file!

To download an example template file, click 'Download Template File' located at the bottom of the 'Import From File' page in zkipster.

Please note: When downloading the template file, it will show all of the default and custom fields of the specific event you are currently working in inside of zkipster. This also means that the fields displayed on the template will change depending on which event plan you purchased, and which features you have switched on.
(For example: Professional Events with the Seating feature enabled will have Table Label and Seat Label columns show up on the template file, etc.)


Uploading a Spreadsheet File into zkipster

1. Click on the orange 'Add Guest List' button (located in the upper right corner)
2. Name the Guest List and click 'Add'

Please note: You are able to have multiple guest lists within the same event. Make sure to give each one a clear naming convention to keep your different lists organized.

3. Inside your Guest List, Click on 'Add Guests'
4. Select 'Import from File'
5. Confirm your Guest List Selection and click 'Next'
6. Select your CSV or XLSX file (or drag and drop it straight into the box)

Next, you will be prompted with a Matching Screen where you will be to match your file's spreadsheet columns to the guest fields in zkipster.


The Matching Screen

Matching Guest Fields Automatically

Any default fields and additional custom fields that have already been set up on your zkipster event or account ahead of time will automatically appear as 'Matched' (for example: First Name, Last Name, etc.) as long as you have followed the exact guest field naming convention on the columns of your spreadsheet, as pointed out in this article.

Matching Guest Fields Manually

You are able to manually match any of the remaining unmatched fields via the dropdown on the right. You can also create new custom fields straight from within the dropdown menu for any fields that are specific to your event. This article explains how to create custom fields in zkipster in more detail.

A green check mark will indicate that the fields have been matched. You are also able to 'Skip a Column' via the dropdown if you decide that you don't want to upload this specific information after all.

Click 'Continue' once all fields have been matched and appear with the green check mark next to them:


Pro Tip:
Familiarize yourself with zkipster's default fields ahead of time in the 'Guest Fields' tab located in the left-hand menu. Follow the same naming convention on the columns of your spreadsheet in order to speed up your guest list upload process.


Assigning Guest Status (When Using the Invitations Feature)

If you are using zkipster's Invitations feature, a pop-up window will prompt you to assign a Guest Status to all guests who have not already been assigned one on your spreadsheet. The pop-up will ask you to assign your guests either a 'Confirmed' or 'Unconfirmed' status:

  • Unconfirmed - Allows you to track guest attendance when planning on sending
    online invitations with zkipster
  • Confirmed - Guests who have already confirmed their attendance to you outside of zkipster

Please note: By making your selection via the pop-up, the system will automatically apply the chosen status (i.e. Confirmed or Unconfirmed) to ALL guests on your guest list. If you already know the Guest Status of all or some of your guests prior to importing your list, it is recommended that you indicate this on your spreadsheet accordingly with an additional 'Guest Status' column. Assign each individual guest one of the following statuses:

  • Unconfirmed
  • Confirmed
  • Declined

You can see an overview of the number of Total Guests, Unconfirmed, Confirmed and Declined guests on the main page of the 'Guests' section on your browser.


Asynchronous Guest List Uploader

zkipster uses an asynchronous guest list importer for large guest list uploads, which gets triggered at the 2000 guests mark for a more stable import and better user experience.

When a list with 2000+ names gets uploaded, the system will internally break it down into smaller chunks, add it to a queue and import each bit one after the other. A pop-up notifies you when an asynchronous import is underway and informs you about the progress:

You would additionally be able to follow the progress of the import via the 'View Progress' button in the notification alert bar at top of your screen:

Once an asynchronous import is underway, another file import cannot be initiated until it has been completed. However you would be able to still add guests individually.
zkipster will notify you via email of the success or failure of the upload. If successful, all imported guests will automatically appear inside your guest list.


Please note:
As a general guideline, we do not recommend exceeding the threshold of 5000 guests within one single event. For guest lists with 2000+ guests, please refer to this article here for best practices and tips.

Did this answer your question?