--- title: "Contact List Upload and Download" slug: "contact-list-upload-and-download" description: "Learn how to upload and export contacts using a properly formatted spreadsheet, manage groups, and avoid duplicates with our comprehensive guide." updated: 2026-05-22T00:42:50Z published: 2026-05-22T00:42:50Z canonical: "www.civicplus.help/contact-list-upload-and-download" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Contact List Upload and Download This article will show you how to upload contacts from a file and export your contacts as a spreadsheet. ## Contact List Upload Multiple contacts can be created/updated at once using the **Import Contacts** tool. Contacts must be in a properly formatted spreadsheet (.CSV, .XLS, .XLSX, and .TXT file types are supported). Likewise, new or existing contacts can be added to groups in bulk from here as well. > [!NOTE] > Important Notes > > - If you wish to import addresses with your contacts and want to be able to select those individuals using the mapping tool for geo-targeting alerts, please [contact Support](/mass-notification/docs/contact-civicplus-support). > - If the file you plan to upload contains existing contacts, ensure that you have their correct contact information in the file to avoid duplicate user creation. Existing users are found/matched based on email or phone numbers. > - If contacts and admins are managed through one of our automated or FTP upload processes, the Contact List Upload feature **should not** be utilized. > - Groups must be created prior to using the Contact List Upload tool if you wish to import contacts to a group. For information on how to create groups, view the [Add a Public Group](/mass-notification/docs/add-and-manage-public-groups) and [Add an Internal Group](/mass-notification/docs/add-and-manage-internal-groups) articles. > - Public sign-up users created with the Contact List Upload feature are automatically activated at creation time. [Embedded content](https://www.iorad.com/player/2205080/Mass-Notification--Upload-a-Contact-List-Tutorial?src=iframe) 1. [Sign in to the system](/mass-notification/docs/sign-in-to-civicready) if you have not already 2. Navigate to **Resources**, then select **Manage Directories** ![The Resources section of the navigation menu with Manage Directories selected.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Manage Directories - MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=muy4FZdrOhKMsGbPjkuOTEHy52joye0taHkivuYnxbM%3D) 3. Click the **Internal Contacts option** if you wish to upload internal users, or click the **Public Contacts option** if you wish to upload public users ![The Internal Contacts and Public Contacts options under the Manage Directories menu.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Internal%20or%20Public%20Contacts%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=OFXG7oa8nyvhCn8uYaZoC6ZYViMfEjt2TgCWhhL2LAQ%3D) 4. Click the **Contact List Upload** button ![Internal contacts page featuring options to add and upload contact lists.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Contact%20List%20Upload%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=S1EYoswRECo256Adj4nDTJuLxpt%2BlVgxpVDUd%2B3gaqw%3D) 5. Drag and drop or select a file to import ![Interface for importing contacts with file upload options and guidelines displayed.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Import%20Contacts%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=j18CfFLnIWaazxwigKKS4RxBm6ovw13CUQlVOTaCboM%3D) > [!WARNING] > Note: > > Click the **View import instructions and guidelines** button to view instructions and download a spreadsheet with the proper columns already set up. ![Instructions for importing files with required fields and supported columns listed clearly.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Import%20instructions%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=gkZ5Lu%2BD39pWNXLTWImCShf4ve2jXeooRKylylhWzP8%3D) 6. (Optional) Expand **Import Options** for additional settings ![Options for importing contacts, including group assignment and updating existing attributes.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Import%20Options%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=eFCBsbxHLM3CROlW%2FxVe%2BPbayAL%2ByXDxLKYp%2FONg6pc%3D) - **Update existing contact attributes:** When unchecked, existing users will only be added to selected group(s). New users will be added to the system and selected group(s). > [!WARNING] > Note: > > If you only wish to add contacts to a group and do not want to update existing contact data, make sure the **Update existing contact attributes** checkbox is left unchecked. New contacts will still be created whether the box is checked or not. - **Assign to Groups:** Select groups to add imported contacts to automatically. > [!WARNING] > Notes: > > - If a group is selected, all new and existing contacts will be added to the selected group(s). > - [Groups must be created](/mass-notification/docs/add-and-manage-internal-groups) prior to using the Contact List Upload tool if you wish to import contacts to a group. 7. Click **Next** ![A button labeled 'Next' is highlighted for user navigation on a webpage.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Contact%20Import,%20Next%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=aXJF7U7f4mptuncmH%2F%2B6WZbEibhTkdKQyw4AIB9lnYY%3D) 8. Preview and validate the import summary ![Import summary showing one total record and one existing contact found.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Preview%20and%20Validate%20Import%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=PEZyCF%2FHzYRrYxpuv2UM4vCJ7T8U1AfkWXvvX427fjI%3D) 9. Click **Confirm Import**![User interface showing options to confirm import or go back in a process.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Confirm%20Import%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=0oaO8ouv5dMEKNMK8KGId02lDEV207ggHTBpm5ls8M0%3D) 10. Review the **Import Results** page![Contact import successful message with details on added and updated contacts.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Import%20Results%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=0cza7Ga8hA35HVupwoiwqBK6yD%2BeSabjA7xhxrLhJgs%3D) 11. The uploaded contacts have been imported --- ## Contact List Download You can use the **Contact List Download** function to export Internal and Public Contacts lists. 1. [Sign in to the system](/mass-notification/docs/sign-in-to-civicready) if you have not already 2. Navigate to **Resources**, then select the **Manage Directories** option ![The Resources section of the navigation menu with Manage Directories selected.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Manage Directories - MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=muy4FZdrOhKMsGbPjkuOTEHy52joye0taHkivuYnxbM%3D) 3. Click the **Internal Contacts option** if you wish to export internal users, or click the **Public Contacts** option if you wish to export public users![The Internal Contacts and Public Contacts options under the Manage Directories menu.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Internal%20or%20Public%20Contacts%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=OFXG7oa8nyvhCn8uYaZoC6ZYViMfEjt2TgCWhhL2LAQ%3D) 4. Click the **Contact List Download** button![User interface displaying contact management options and a highlighted Contact List Download button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Contact%20List%20Download%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=CCvDdpq9AcmQwcnNFH9pHsbCD%2BpWHZDAtjkxXQPh2MA%3D) 5. Check the **Include Group Memberships** checkbox to include information about each contact's group memberships, if desired![Popup window for exporting contacts with option to include group memberships highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Export,%20Include%20Group%20Memberships%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=msSjU6RppujXpHpKilfaeVmx0FvnWbX7Nv1nEa2CcOw%3D) 6. Click the **Begin Export** button to download an Excel file with the contacts![Popup window for exporting contacts with options to include group memberships.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Begin%20Export%20-%20MN.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A43%3A33Z&se=2026-11-22T13%3A43%3A33Z&sr=b&sp=r&sig=5fZeTg%2FgTv%2FOkyyQtYj7oyWAVu7nAd9q91H%2BiwxumQw%3D) 7. Open and view the Excel file with the contact details Comma-separated Value. Excel spreadsheet. Excel Open XML Format Spreadsheet. Text File Document. File Transfer Protocol.