Rate this page:

Migrating from Legacy Transactional Templates

If you have transactional templates you want to use with handlebars syntax, you need to migrate your legacy templates to the new dynamic templates page.

The original template you copy won't be modified and remains active in any API or SMTP calls. To use the new template, update the template ID parameter in your code.

To convert a legacy transactional template:

  1. Navigate to the legacy templates page.
  2. Create a version of the template you wish to migrate or select the actions menu on the template version and select Edit. The template opens in the editor and a green banner appears at the top of the page specifying that the template you are editing is a legacy template.
  3. Select Copy as New Template.
  4. Give the template a new name and click Copy as New Template.
  5. Once the template is successfully copied over, click Continue. The template opens in the editor and you are prompted to replace any existing substitution tags with handlebars syntax.
  6. To replace any existing substitution tags, click Replace your substitution tags.
  7. Enter the opening and closing characters of your substitution tags and click Replace.
  8. The module replaces all of the substitution tags in your template with handlebars. For example,{{your_tag_here}}.

Additional resources

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more