Email Settings

Setup and edit email notifications

Kenzie avatar
Written by Kenzie
Updated over a week ago

B2B Edition Email Templates

What We’ll Cover

  • Requirements

  • Available templates

  • Managing email templates

  • Editing template phrases

  • Editing template code

  • Previewing template customizations

  • FAQ

B2B Edition allows you to automatically send email notifications to buyers after certain actions, such as Company account approval or the creation of an invoice. Emails settings in the B2B Edition dashboard include templates for buyer-facing emails, and allow you to customize the text and code to suit your store and brand.

(info notice)Do your templates look different? We recently updated B2B Edition’s Emails settings to offer more customization. See Transactional Email Templates In B2B Edition to learn more about using the new experience.

Requirements

Your B2B Edition user account must have the following permissions enabled to edit email templates:

  • View Settings

  • Update Settings

To edit the New invoice, Invoice reminder, and Invoice past due templates, your user account must also have the following invoice permissions enabled:

  • View Settings

  • Update Settings

Available Templates

The following email templates can be customized in the B2B Edition dashboard:

  • New company created — sent to the Company admin user when a new company account is created

  • New user created — sent to a new user that has been added to a Company account

  • New company rejected — sent to the Company admin user when their Company account application is rejected

  • New super admin created — sent to a new user that has been assigned as a Super Admin

  • Shopping list approval request — sent to Company admin and Senior Buyer users in a Company account when a Junior Buyer submits a Shopping List for approval

  • Shopping list status updated — sent to the Junior Buyer user when an approver approves or rejects their pending Shopping List

  • Quote reminder — sent at preset intervals to the contact email in a quote to inform them of the quote’s expiration date

  • New invoice — sent to the buyer who placed an order when an invoice is created for that order

  • Invoice reminder — sent at preset intervals to the buyer who placed the original order to inform them of the invoice’s expiration date

  • Invoice past due — sent at preset intervals to the buyer who placed the original order after an invoice has expired

  • New quote (merchant email) — sent to specified B2B Edition users when a buyer requests a quote from the storefront

Managing Email Templates

B2B email templates are located in SettingsEmails in the B2B Edition dashboard. Each template is given a label so that you can confirm at a glance if it is currently enabled or disabled. All email templates are enabled by default.

Using the drop-down list at the top of the page, you can select whether you want to view the default global templates or specific templates for each storefront provisioned in B2B Edition. You can also select the global or storefront-specific version of a template while editing it.

Click a template’s name to edit its phrases or code. You can also Enable or Disable a template from its Action menu in the template list or at the top of the page while editing the template. If you use a third-party email integration, you may want to disable the built-in email templates to prevent your buyers from receiving duplicate emails.

While editing the global version of a template, you can select Reset to system defaults from the Action menu to restore the template’s original phrases and code.

(warning notice)Once a global template has been reset, it is not possible to recover any previous customizations. We recommend copying your template code and saving it in a plain text editor before resetting it to default values.

Storefront-specific templates cannot be reset to their default values. Instead, you can check the box next to Use global to send the global template in its place.

Template-Specific Settings

Some settings are only available in specific email templates, and allow you to make additional configurations to their behavior. These settings are accessed by clicking the template name, or by selecting Edit from the Action menu. Note that template-specific settings apply to all storefronts and cannot be configured on the storefront level.

The Quote reminder and Invoice reminder templates include a Retry Days Before Expiration Date setting, which indicates how many days in advance that a buyer should be notified about the impending expiration of their quote or invoice. Enter a whole number to specify the number of days before the expiration date when the email is triggered. You can enter multiple numbers, separated by commas, to send the email multiple times before the expiration date.

In the Invoice past due template, use the Retry Days After Due Date field to specify when to notify buyers of an overdue invoice. Enter multiple numbers separated by commas to configure multiple sending intervals.

To designate a member of your staff to receive the New quote notification, enter their email address in the Define the email of the recipient field. Click +Add additional email to enter multiple recipient addresses.

Editing Template Phrases

The Phrases tab of the template edit page is where you can add and edit the text used in the email. Each phrase consists of a Phrase name which is used as an internal identifier in the template’s code, and a Phrase value which is the text that appears in the email itself.

Edit an existing phrase’s name or value by entering new text in the corresponding fields, or remove a phrase from the template by selecting Delete from its Action menu. Note that editing or deleting a Phrase name identifier will not change or remove it from the template’s code; you must make corresponding adjustments in the Code tab.

To create a custom phrase in your template, click + Add New and enter the new name and value in the resulting fields. As with editing or deleting an existing phrase, you must enter the Phrase name in the template code for the text to appear in the email.

The Phrase value field supports the use of HTML and template variables. For example, you can create a phrase with a name of “contact” and a value like “Need help? Contact {store}’s Support team at <a href="mailto:[email protected]">[email protected]</a>.” to provide your buyers with a clickable email link. By using the store.name variable, you can add the same phrase to multiple storefronts without having to adjust the text.

Editing Template Code

In the Code tab, you can edit the HTML and CSS content of your email template, as well as create a custom subject line. The Subject field can have a maximum of 255 characters; however, you can use phrase names and variables to include additional content and insert buyer-specific information.

For example, you can personalize the Shopping list status updated template with a subject of “{{submitter.name}}, {{{ lang 'subject' }}}”. This includes the name of the Shopping List creator in the subject, and allows you to insert a custom phrase value.

(info notice)Editing code? We recommend saving a backup copy of your template in a plain text editor such as Notepad or TextEdit. You can also restore the default version of an email's global template if needed.

The body of the template is customized by editing its underlying HTML and Handlebars code. It is divided between CSS styling at the top and HTML content at the bottom. We recommend making edits by copying the template code into a text editor and pasting the edited version back into the Content box.

Following the example in the previous section, you can add your custom phrase name to the bottom of the template. To do this, locate the <!-- prevent Gmail on iOS font size manipulation --> HTML comment and add paragraph tags above it. In the paragraph tags, add the phrase bracket in the format of {{{ lang 'contact' store=store.name }}}. You can then assign a class to the paragraph and style it in the CSS section of the template.

To learn more about how you can customize your email code, see Email Templates Code Examples in the Dev Center. While this covers email templates in BigCommerce and references variables that may not be present in B2B Edition templates, the HTML customizations can be applied to both sets of templates.

Previewing Template Customizations

The Preview tab provides you with an example of how your template customizations will appear before saving your changes. Click the desktop or mobile icon to see how the email is formatted in different devices.

If you want to view how the template will appear to the recipientin your email host, click Send test email. The resulting email is delivered to your user account email address.

The template preview and test email use placeholder values to fill in buyer-specific variables, such as their email address or Company name. Similarly, any links in the preview direct to your storefront URL instead of the corresponding area of the Company’s Buyer Portal.

If you need to adjust any of your customizations, return to the Phrases and Code tabs. When you’re ready to apply the updated template to live emails, Save your changes.

Available Variables

New Company Account Welcome Email

Variables

store.name

store.login_url

company.name

user.email

password.reset_url

New Company User Welcome Email

Variables

store.name

store.login_url

company.name

newuser.email

inviter.name

inviter.email

password.reset_url

New Company Account Rejection Email

Variables

store.name

store.login_url

company.name

user.email

user.name

Shopping List Approval Submission Email

Variables

store.name

submitter.name

submitter.email

shoppinglist.name

shopping_list.url

company.name

Shopping List Approval Status Email

Variables

store.name

submitter.name

submitter.email

approver.name

approver.email

shoppinglist.name

shoppinglist.url

company.name

New Super Admin Welcome Email

New Variables

store.name

store.login_url

user.email

password.reset_rul

Quote Reminder

Variables

store.name

store.login_url

company.name

quote.number

quote.amount

quote.expired_at

quote.created_at

quote.details_url

quote.contact_name

quote.reminder_days

Request for Quote

Variables

store.name

company.name

quote.title

quote.details_url

quote.contact_name

quote.contact_email

Invoice Creation

Variables

store.name

store.login_url

company.name

order.number

invoice.number

invoice.currency

invoice.total

amount.due

invoice.date

invoice.detail_url

invoice.contact.email

Invoice Reminder

Variables

store.name

store.login_url

company.name

invoice.number

invoice.total

invoice.date

invoice.due_date

invoice.detail_url

invoice.contact_email

invoice.reminder_days

Invoice Past Due

Variables

store.name

store.login_url

company.name

invoice.number

invoice.total

invoice.date

invoice.detail_url

invoice.contact_email

invoice.past_days

Need a variable not listed? Please submit a feature request!

FAQ

Can I customize the email sent when creating or updating a quote in the B2B Edition dashboard?

You can select a preconfigured template and enter a personalized subject line while submitting quotes to buyers, but it is not possible to edit the phrases or code of the quote templates.

Can I specify the sending email address for B2B Edition emails?

By default, emails in B2B Edition are sent from [email protected]. If you are using a third-party email service, you can assign a different sending email address by connecting an external SMTP server in your General settings. Note that this sending address is only used for emails with customizable templates, not for system-generated emails like the new user invitation.

Why are my emails showing raw HTML instead of the phrases or variables I added to the template?

A custom variable or phrase added to the Code section of your email template can appear as raw HTML if it is contained within two curly brackets instead of three. For example, {{ lang 'yourcustomphrase' }} will display as raw HTML, but {{{ lang 'yourcustomphrase' }}} will properly display your custom phrase.

Additional Resources

This article will be moving to:

Did this answer your question?