Import or Export Your Guest List

If you’ve already organized your wedding guests into a spreadsheet, you can import it into Joy. If you’ve already entered guests into your Joy guest list, importing a list will append to your list, not replace it.

1. Format your spreadsheet

Joy will import the names and emails of your guests, and group them as parties, as long as your spreadsheet is formatted in the following way. We have a Google Sheets template you can start with or use as a reference.

Formatting guidelines

  • Starting in the first column, the first row of your spreadsheet must contain column headings for first name, last name, and email. This is the only requirement. Please note: the column headers need to be in all lowercase letters and cannot contain any additional characters.
  • If you’d like, include a column heading for party. This is optional.
  • Each individual guest must be in their own row.
  • For a given guest, all fields are optional. You can import a guest with just a first name, last name, email, or party. But at least one of these is required; completely blank rows won’t be imported.

Parties and plus ones

To group guests as parties, enter the same party value, such as “The Smiths”, for each guest in the party. Joy will automatically group these guests as a party in your guest list.

This works for plus ones, too. In the example above, the guest Christopher Wallace has a plus one: The party “CW” groups this guest with an otherwise blank row, whose details can be added after importing.

The party can be named anything you want, such as “The Smiths”, or “Joe P and guest” or “Mary W and family”. This value won’t be visible in Joy; it’s just used to group your guests together under the hood.

2. Save your spreadsheet as a CSV file

Once you’ve formatted your guest list, save it as a CSV file. CSV (“Comma-separated values”) is a common format, supported by Excel, Google Sheets, and Numbers, that Joy can easily read.

  • From Excel: File > Save as … > Save as type > CSV
  • From Google Sheets: File > Download > Comma-separated values (.csv, current sheet)
  • From Numbers: File > Export to… > CSV…

3. Import your CSV file into Joy

Once you’ve saved your formatted spreadsheet as a CSV file, you’re ready to import it into Joy. From your admin dashboard, click Guest List, then Add Guests in the upper right:

From there, click Import Guest List:

Browse your computer to find the file that you want to upload. Or, if your file is on Google Drive or Dropbox, you can connect to those accounts and find your file.

That’s it! All the guests on your spreadsheet have been added to your guest list, and grouped as parties. You’re ready to send Save the Dates and Invitations.

Exporting your Guest List

You can export your guest list to work with it in another program or to print it. Click Export All Guests on the guest list toolbar at the top of the guest list page. Your guest list will automatically download to your computer as a CSV file, which can be opened it in Excel, Google Sheets, and Numbers.

Still have some questions?

Ask us directly! Click on the black and white chat bubble in the bottom-right corner of this page to ask us your questions, or you can email us at You’ll get a friendly response from someone on our team! 🙂

Updated on January 20, 2021

Was this article helpful?

Related Articles