- A/B Testing
- Where can I manually select the winner of an A/B test campaign?
- When can I manually select the winner of an A/B test campaign?
- Can I change the winning criteria after sending an A/B test campaign?
- Can I see which A/B test variation was sent to each recipient?
- Can I export raw stats for each of my A/B test variations?
- Billing & Pricing
- Campaigns & Campaign Editor
- How come I can’t select a sender ID in the campaign editor after creating it?
- If I send a campaign to multiple lists or segments, will contacts on each list receive a duplicate email?
- When scheduling a campaign, why do I get the error: “Please choose a future date and time for sending your campaign”?
- How do I edit a scheduled campaign?
- Can I restore a deleted campaign?
- Where can I get a list of all of my substitution tags to insert into my campaign?
- Can I use substitution tags in my subject line?
- Where are uploaded images stored and how do I access them?
- Are unsubscribe links automatically added to my campaign?
- Why is my unsubscribe tag not being replaced with an unsubscribe link?
- What is a suppression group?
- What is the difference between suppression groups and unsubscribe groups?
- Where can I find a list of contacts who have marked one of my campaigns as spam?
- How many campaigns can I create?
- Contacts & CSV Uploading
- How come my list and segment counts aren’t updated after adding new contacts?
- How do I add an existing contact to an existing list?
- How do I update the custom fields for one of my contacts?
- How do I update an existing contact list?
- Why am I receiving errors when uploading a CSV?
- What do I need to know to format my CSVs correctly?
- Why does my contact upload summary email show a smaller total than the number of contacts I uploaded?
- What is the file size limit when uploading CSVs?
- How long will it take to upload a CSV?
- Sending Campaigns
- How come one of my substitution tags wasn’t replaced during a send?
- Why aren’t my substitution tags replaced in my test send?
- Why isn’t my unsubscribed contact appearing in an unsubscribe group?
- How do I unschedule a campaign that I don’t want to send?
- How do I stop a campaign send?
- Can I retrieve Marketing Campaigns events via the Event Webhook?
- Can I turn off open/click tracking?
- When a recipient clicks the unsubscribe link in my campaign, are they unsubscribed from all of my emails?
- Why am I required to select an unsubscribe group when sending a campaign?
- Sender Verification
You can navigate to the campaign’s stats to select a winner.
You will receive an email reminding you to manually select a winner when your A/B test has completed. However, you may manually select a winner at any time immediately after beginning an A/B test campaign— you do not have to let the test finish before selecting a winner.
No, you cannot change the winning criteria after starting an A/B test.
No, currently you cannot see which recipient received which version.
Yes! Simply click the “Export CSV” button on the campaign stats page. The exported CSV will contain a line of stats for each individual variation you sent.
Yes! The link tracking tab on your campaign’s stats page displays your link click tracking stats for each version of your test.
To see these stats, click Campaigns under Marketing Campaigns in the left hand side bar. Click the gear icon next to your A/B test campaign and select Stats. Scroll down until you see the section titled Link Tracking. Here you will find your click tracking stats for all of the links in each of your test versions.
You can find your invoice in your SendGrid Billing Settings. From your SendGrid dashboard, click Settings then Plan & Billing Details. Here you can find how much you are being billed for stored contacts (e.g. how much you are charged per 10,000 contacts) as well as the total you owe.
Contacts stored on any subusers of your account will be included in your total.
You will be charged to store all of your contacts, regardless of whether or not some contacts have unsubscribed from one or more campaigns. You are also charged to store any contacts on your subusers’ accounts. As with your parent account, each subuser can store up to 2,000 contacts for free.
Your parent account will be billed for each unique contact, regardless of how many lists or segments that contact appears on. However, if there are one or more subusers under a parent account, the parent account will be billed for all unique contacts stored on each account, even if the same contact is stored on multiple accounts.
For example, if a SendGrid parent account uploads a contact with the address
firstname.lastname@example.org and a single subuser of that parent account also uploads a contact for
email@example.com, then the parent account will be billed twice for that contact.
Unsubscribed contacts will not consume email credits when you send via Marketing Campaigns, even if those unsubscribed contacts are included in the list or segment you are sending to.
However, sending campaigns to invalid email addresses, recipients who have marked your emails as spam, or addresses that bounce will still consume email credits from your monthly balance.
You will be charged $10.00 for every 10,000 contacts you store. Your first 2,000 contacts are free. For a detailed discussion of Marketing Campaigns pricing, please see our pricing page.
There is no monthly proration for contact storage. You will be charged for the maximum size that your contact list reaches each month. For example, if you upload your contacts on the last day of the month, you will still be charged the full amount to store those contacts that month.
Make sure that you have verified the sender ID you are trying to select. You can only select a verified sender ID when sending a campaign. You can resend a sender ID verification email from the sender ID’s details page. Any sender you create using a domain you have already whitelabeled will automatically be verified.
If I send a campaign to multiple lists or segments, will contacts on each list receive a duplicate email?
No, each recipient will only receive a campaign once regardless of how many times they appear on a list or segment.
When scheduling a campaign, why do I get the error: “Please choose a future date and time for sending your campaign”?
This error occurs if you enter a time in the past to deliver a campaign. Make sure that your timezone is set correctly in your Account Details.
First, unschedule the campaign that you want to edit— this will return your campaign to “draft” status. When finished editing your campaign, simply reschedule your desired send time.
Deleted campaigns cannot be restored. When deleting a campaign the application will ask you to confirm your choice to delete. Please be careful when deleting campaigns.
When in the Campaign Editor, click the Tags tab in the left hand sidebar. Here you will see a full list of your substitution tags, along with icons you can click to easily copy a tag.
Yes, using substitution tags in your subject line is a great way to further customize your emails for each of your recipients. It’s worth noting you can use emoji here as well.
All images uploaded are stored in your image library and are shared between transactional templates and Marketing Campaigns. To access your images, simply open a campaign in the Campaign Editor (or a transactional template) and click the small image icon in the toolbar.
Every campaign is required to have the [unsubscribe] tag, and the [unsubscribe] tag will automatically be appended in every SendGrid template.
However, you can specify the exact location in your email that you would like the unsubscribe link to appear by inserting the [unsubscribe] tag at a location of your choice. For more information on adding unsubscribe links to your campaigns, click here.
Make sure that you have inserted the [unsubscribe] tag in the body of your campaign and have selected an unsubscribe group for your campaign. You must specify an unsubscribe group or include a custom unsubscribe URL in order for the unsubscribe link to be added and for your campaign to be sent. For more information on adding unsubscribe links to your campaigns, click here.
An unsubscribe group is a group of recipients that we will not send emails to. Unsubscribe groups allow your readers to opt out of certain types or groups of emails instead of globally unsubscribing from all of your emails. A common example, would be to have one group for “Account” messages like password resets and shipping notifications, and another group for “Marketing” messages, so that users unsubscribing from marketing email don’t mistakenly miss password reminder emails. For more information on using unsubscribe links in your campaigns, click here.
Suppression groups and unsubscribe groups are the same. We refer to suppression groups as unsubscribe groups. For more information on using unsubscribe links in your campaigns, click here.
You can find a list of contacts who have marked one of your campaigns as spam by clicking Stats from the left hand navigation menu then filtering the results by “Spam Reports”. You can apply a category to a campaign or series of campaigns to further filter these stats.
You will not be able to see which specific campaign was marked as spam unless you assign a unique category for every campaign.
You can create up to 2500 different campaigns.
It is normal to see a slight delay between uploading contacts and seeing your list counts get updated, but if you still don’t see your list counts updated after 30 minutes please reach out to Support or your Customer Success Manager.
Navigate to your contacts page and search for the contact that you want to add. Click on that contact and scroll down until you see the Associated Lists tab. On this tab you’ll find a drop down menu allowing you to select a preexisting list to add this contact to.
You can re-upload a CSV containing your new custom fields. You can also manually edit the custom fields for an individual contact by navigating to your Contacts page in Marketing Campaigns, searching for and selecting the contact that you want to update, and scrolling down to the Custom Fields tab. Finally, click Edit to begin updating your contact’s custom fields.
You can either upload a CSV of contacts to an existing list or you can manually add contacts to a list.
To upload a CSV to an existing list, navigate to the Contacts page and click Add List or Segment. Click Upload CSV. Under the dropdown menu titled Add to an existing list select the list you want to add your new contacts to. Continue with the CSV upload process as described here.
To manually add a contact to an existing list, navigate to the Contacts page and click Add List or Segment. Click Manual Add. Under the dropdown menu titled Add to an existing list select the list you want to add your new contact to. Continue adding your contact as described here.
The most common reason users receive errors when uploading CSVs is that there are incorrectly formatted dates in the CSV file. Make sure that your dates all have 4 year digits and are in MM/DD/YYYY format. If you are still having problems, double check the CSV upload steps described here.
- Only .csv files are allowed
- A header row is required for all CSV uploads
- “Email” header field is always required
- Headers must use letters, numbers, and underscore characters only
- Date fields can be represented in the form: MM/DD/YYYY
- Years in date fields must be represented as their full value (e.g. 1999 not 99)
For more detailed info, check out this page on Preparing your contacts for upload.
Why does my contact upload summary email show a smaller total than the number of contacts I uploaded?
You have probably uploaded duplicate contacts. Double check your CSV for duplicates, and if you are certain there are none, please reach out to your Customer Success Manager or contact Support.
You can upload CSV files up to 2GB in size.
With a relatively simple CSV containing only the email, first_name, and last_name fields you should expect to see 8 million contacts uploaded in 6 hours (or about 2.7 seconds per 1,000 contacts). As you increase the number of custom fields included in your CSV, the amount of time required will increase.
We currently only allow full word searches when searching for custom field values. The only exception is email addresses: you may search for parts of a word or address when looking up email addresses. For example, a search for “gmail” might return gmail.com, gmail.cn, x.gmail.com, etc.
To quickly view which recipients have either opened one of your campaigns or have clicked within one of your campaigns, click Campaigns under Marketing Campaigns in the left hand navigation menu. Click the campaign you’re interested in, and hover your cursor over either the “Unique Opens” or “Unique Clicks” tile and click View Details.
You can also create a segment of recipients that have either opened or click within one of your campaigns based on your campaign’s engagement statistics. For detailed instructions on how to use your engagement stats, visit our User Guide. For other ideas on how to leverage these engagement stats, checkout this classroom article.
You can create up to 100 lists and 100 segments. Each resource is independently limited to 100. In other words, you can create 100 lists and 100 segments, but not 200 of one and 0 of the other.
If one of your substitution tags wasn’t replaced during a send, make sure that there is a value associated with that substitution tag. Search for the email address of the recipient that received the faulty email and double check the value of a custom field you may have used. You should also make sure that you spelled the substitution tag correctly when building the campaign.
The Send Test feature doesn’t replace any substitution tags - it is only intended to show you how your campaign will be rendered in different email inboxes.
It can take up to 5 minutes before an unsubscribed contact will appear in an unsubscribe group.
You can unschedule a campaign by navigating to your list of campaigns, clicking the action cog next to the campaign you want to stop and clicking Unschedule. This returns the campaign to “draft” form. Also see How do I edit a scheduled campaign? for additional detail.
When a campaign is in progress, a red X will appear next to that campaign on your campaigns page. Click this X to cancel your campaign. NOTE: you cannot resume a cancelled campaign. For more information on stopping sends in progress, see Can I stop a send in progress?
Yes! We send events from Marketing Campaigns to the Event Webhook, including A/B test campaign events.
No, click tracking is permanently enabled for all links included in your campaigns. Even if you disable click tracking under your general SendGrid settings, links clicked in your campaigns are still included in your link click tracking totals.
However, by adding the attribute
"clicktracking=off" to the
<a> tag of a link in one of your campaigns before the href attribute, you can prevent that link from being included in the link click tracking table for that campaign.
Clicks on this link are still recorded under your general SendGrid stats and the aggregate Campaign stats. To learn more about click tracking in Marketing Campaigns, click here.
For example, the link:
<a clicktracking="off" href="www.example.com">Example Link</a>
would not be included in the link click tracking table, but it would still be counted in your overall SendGrid stats and the aggregate click tracking stats for the campaign.
When a recipient clicks the unsubscribe link in my campaign, are they unsubscribed from all of my emails?
No, Marketing Campaigns uses unsubscribe groups that allow you to specify which groups of marketing email your recipients subscribe to. For more information on how to use unsubscribe groups, click here.
All email sent through Marketing Campaigns is required to have an unsubscribe link allowing recipients to quickly and easily unsubscribe from your emails.
The [unsubscribe] tag must always be present, and you must always either select an unsubscribe group or include a custom unsubscribe URL. For detailed instructions on adding unsubscribe links to your campaigns, click here.
If you didn’t receive a sender ID verification email, try requesting the verification email to be resent. Simply navigate to Marketing Campaigns in the left hand navigation menu and click on Senders. Next to the sender you need to verify, click the action cog and select Resend Verification.
If you clicked the link in your sender ID verification email, but had to sign into SendGrid again, then your sender ID wasn’t verified. You must be signed into SendGrid before clicking the verification link in your email.
The URL in your sender ID verification email is valid for 48 hours. After 48 hours you will have to request a new verification email to be delivered. To resend your verification email, navigate to Marketing Campaigns in the left hand navigation menu and click Senders. Next to the sender you need to verify, click the action cog and select Resend Verification.
No, these stats are specific to the email you send over Marketing Campaigns only.
You can go into the settings menu after your campaign has started sending, and there will be a link for “Stats”.
You can always export a CSV of raw stats for any of your campaigns. That will include stats like CTR, total open rates, spam report rate, and more. To learn more about stats from Marketing Campaigns, click here.
Additionally, you can use SendGrid’s Event Webhook to collect and store your Marketing Campaigns statistics.
Currently, you can see your aggregate stats over all time, and the graph displayed on the Marketing Campaigns Overview page displays stats for the previous 7 days.
Under Marketing Campaigns in the left hand navigation menu, select Campaigns. Find the campaign you want to see stats for in the list and click the action cog on the right. Click Stats to view statistics for that specific campaign.