1. Open Mailmeteor

• Go to https://mailmeteor.com and sign in with your Google account.

• Or, open Gmail, click the Mailmeteor icon (puzzle piece or extension icon) from the sidebar, and select Mailmeteor.

2. Start a New Campaign

1. Click the Campaigns tab in Mailmeteor.

2. Select New campaign.

3. Select Your Recipients

You can add recipients in one of the following ways:

• Google Sheets — connect a spreadsheet containing your contact list.

• Import from CSV file — upload a CSV with names and email addresses.

• Existing contact list — choose a saved list in Mailmeteor.

• Copy / Paste — directly paste email addresses into the recipient field.

4. Compose and Personalize Your Email

• Use Gmail’s built-in editor to write your message.

• To use a saved design, click the More options button (⋮) → Templates → select your template.

• Click Insert variable {{ }} to add personalized fields such as:

  • {{FirstName}}

  • {{LastName}}

  • {{Organization}}

(These variables pull data from your spreadsheet or imported file.)

5. Review and Send

• Click Preview emails to check personalization and formatting.

• Select Send to deliver immediately, or Schedule to send later.

• Track results from your Mailmeteor Dashboard — see opens, clicks, and bounces.

Tips

• Always test your campaign with your own email first.

• Avoid sending too many emails at once to prevent Gmail sending limits.

• Keep subject lines short and clear to improve open rates.

1. Open the Mailmeteor Dashboard

• Go to https://app.mailmeteor.com

• Sign in with your Google account (the same one linked to Gmail).

• You’ll be taken to your Dashboard, where you can manage all campaigns.

2. Start a New Campaign

1. Click the ➕ New campaign button (top right).

2. A new campaign setup window will appear.

3. Add Your Recipients

You can import recipients using one of these options:

• Google Sheets – Connect a spreadsheet containing recipient details.

• CSV file – Upload a CSV with contact information.

• Existing contact list – Select a previously saved list.

• Manual entry – Copy and paste email addresses directly into the field.

Each contact can include custom data (e.g., FirstName, Department) for personalization.

4. Compose Your Email

• Enter your Subject line and Email body.

• Use the {{variable}} button to insert personalized fields (like {{FirstName}}).

• You can:

  • Write your own email using the editor.

  • Or import a template by clicking More options (⋮) → Templates.

• Add attachments if needed.

5. Preview and Test

• Click Preview emails to check personalization and formatting.

• (Optional) Send a test email to yourself to verify how it looks.

6. Send or Schedule

• Choose Send now to send immediately, or

• Click Schedule to send at a specific date/time.

Mailmeteor automatically tracks each email’s delivery and engagement.

7. Track Your Campaign

After sending, return to the Dashboard:

• Click your campaign name to view analytics.

• See:

  • Delivered

  • Opened

  • Clicked

  • Bounced

• Use this data to measure engagement and improve future campaigns.

A blank screen when opening or using Mailmeteor usually indicates a browser account conflict, an unformatted spreadsheet file, or an authorization timeout.

Please try the following troubleshooting steps to resolve the issue:

1. Test in an Incognito / Private Window (Most Common Fix)
   • If you are logged into multiple Google accounts in your browser, Google Workspace add-ons can fail to authenticate properly.
   • Open a private or incognito browser window, log into ONLY your Geneseo Google account, open your Google Sheet, and try launching Mailmeteor again.

2. Launch Directly from Google Sheets
   • Instead of starting from the Mailmeteor web dashboard, open your file in Google Drive.
   • In the top menu, go to Extensions > Mailmeteor > Open Mailmeteor.

3. Verify File Format
   • Mailmeteor requires a native Google Sheet. If your file is a Microsoft Excel (.xlsx), CSV, or TSV file uploaded to Drive, Mailmeteor will stall when attempting to read the data.
   • Open the file in Google Drive, go to File > Save as Google Sheets, and run Mailmeteor from the newly created sheet.

4. Clear Cache or Try a Clean Sheet
   • Browser ad-blockers or accumulated cache can prevent the Mailmeteor pop-up from loading. Try clearing your browser cache or temporarily disabling extensions like ad-blockers.
   • If the file has thousands of blank rows or heavy formatting, try copying just your recipient data into a fresh, empty Google Sheet and opening Mailmeteor from there.

5. Reinstall the Add-on
   • If none of the above work, go to Extensions > Add-ons > Manage Add-ons in Google Sheets.
   • Uninstall Mailmeteor, refresh your browser window, and reinstall it from the Google Workspace Marketplace to refresh your authorization tokens.

Mailmeteor might have issues authenticating your account. Most of the time, it happens when you have multiple Google accounts logged in your browser. Read more about what to do if you can’t open Mailmeteor.

If you have scheduled your campaign or sent your emails with Autopilot, you can track the progress of your campaign under Mailmeteor Dashboard.

Under your Mailmeteor Dashboard, click on your campaign to check its status. In the campaign report, you will find details about your ongoing campaign, such as the date when emails will start sending or if there are any errors preventing your emails from being sent.

You’re trying to personalize your emails but variables won’t work? The variables shows as “Hello {{firstname}}” instead of pulling data from your spreadsheet? In that case, have a look at our checklist to prevent any mail merge issues.

If your attachment is not sending with your emails, it might be due to the file size being too large or a temporary connection issue.

1. Please make sure your attachment size is below 5MB. You may need to use an online service to compress your files such as a PDF compressor.
2. Try to create a new template in Mailmeteor and attach your file again. This might solve a download issue due to a temporary connection loss.

If you need to send files over 5MB, please refer to this quick guide to help you do this: send attachments in Mailmeteor.

If you are using an email alias but emails are not sending correctly, the main reason might be that your email alias is not well configured in Gmail. Indeed, Mailmeteor falls back to your primary email address when your alias is not properly set up.

How to solve an email alias not working properly:

1. Check that your alias is well configured in Gmail using Mailmeteor’s Gmail alias checker
2. Once you made sure your alias is set up correctly, try to send a test email from your Gmail account with your email alias
3. If everything works in Gmail, then it will work in Mailmeteor too!

To refresh your tracking report, please proceed as follow:

1. Close your tracking report window
2. In your Google spreadsheet, click on “Add-ons” > “Mailmeteor” > “Tracking report”
3. It will open again your tracking report and refresh your data

Note that you can also check your campaigns metrics from within Mailmeteor Dashboard.

Here are two great guides to help you deal with spam issues:

• Mailmeteor sending guidelines
• 10 tips to improve Gmail deliverability

Take some time to review your emails using these guidelines. Most of the time, a spam issue comes from your own email reputation or email copy. That’s why we advise to work on these aspects in priority. If you still have no clue as to why your emails are going to spam, contact us so that we can review your situation together.

If Gmail prompts this error after you’ve run a mail merge, it means that you’ve reached your sending capacity or that your email was detected as spam. Mailmeteor sends emails using your own Gmail account, this means that when your account reaches this limit, you can’t send emails for a period of around 24 hours. Read this guide to learn more about how to fix this issue.