{
    "componentChunkName": "component---src-templates-article-page-template-js",
    "path": "/concepts/email-notifications/",
    "result": {"data":{"markdownRemark":{"frontmatter":{"title":"Email notifications","slug":"email-notifications","updated":"2022-07-21T00:00:00.000Z","category":"concepts-messages","ingress":"Email notifications are messages users receive when something important happens on the marketplace (e.g., the user has received a message or a payment on the platform). Notifications get delivered via email.","skills":null},"htmlAst":{"type":"root","children":[{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Sharetribe Flex sends email notifications to users when specific events\noccur in your marketplace. There are two categories of email\nnotifications in Flex: built-in email notifications, which relate to\nuser account management, and transaction process emails, which get\ntriggered at specific stages of transactions. For instance, an built-in\nemail notification gets sent when a user changes their email or password\nor when they need to verify a new email address. A transaction process\nemail can inform the user of a successful payment or a new booking\nrequest."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"h2","properties":{"id":"enable-email-notifications","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#enable-email-notifications","ariaLabel":"enable email notifications permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","height":"16","version":"1.1","viewBox":"0 0 16 16","width":"16"},"children":[{"type":"element","tagName":"path","properties":{"fillRule":"evenodd","d":"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"},"children":[]}]}]},{"type":"text","value":"Enable email notifications"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Email notifications are automatically enabled in your test and dev\nmarketplaces. However, in your live marketplace, you must\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/how-to/set-up-outgoing-email-settings/"},"children":[{"type":"text","value":"configure outgoing email settings"}]},{"type":"text","value":"\nfor email notifications to work."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Users will not receive email notifications until they have verified\ntheir email address. Sharetribe does not send emails to unconfirmed\naddresses to avoid people flagging those as spam emails, as that can\nhurt your marketplace's ability to send mail to legitimate users."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Do note that built-in email notifications can not be disabled."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"h2","properties":{"id":"built-in-email-notifications","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#built-in-email-notifications","ariaLabel":"built in email notifications permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","height":"16","version":"1.1","viewBox":"0 0 16 16","width":"16"},"children":[{"type":"element","tagName":"path","properties":{"fillRule":"evenodd","d":"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"},"children":[]}]}]},{"type":"text","value":"Built-in email notifications"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"There are seven built-in email notifications, all of which are related\nto your users' account management. Use the\n"},{"type":"element","tagName":"a","properties":{"href":"https://flex-console.sharetribe.com/","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"Console"}]},{"type":"text","value":" to manage the built-in\nemail notifications. You can customise built-in emails using the\n"},{"type":"element","tagName":"a","properties":{"href":"https://flex-console.sharetribe.com/email-templates","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"Built-in email template editor"}]},{"type":"text","value":"\nin the Flex Console. You can find the editor in the Console under the\nBuild section."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"The email templates use the\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/references/email-templates/#handlebars"},"children":[{"type":"text","value":"Handlebars template language"}]},{"type":"text","value":".\nIn each template, you can use a set of predefined context variables\n(such as the name and email of the recipient). You can find all context\nvariables to the right of the built-in email template editor. You can\naccess user extended data through the context variables, if you want to\ncustomise email content further."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"The built-in email template editor does not include a visual editor, but\nif you want, you can design your email in any\n"},{"type":"element","tagName":"a","properties":{"href":"https://en.wikipedia.org/wiki/WYSIWYG","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"WYSIWYG"}]},{"type":"text","value":" email editor you find\nonline and paste the resulting HTML into the built-in email editor. You\ncan then preview the email by sending it to your email address by\nclicking on \"preview\" and pressing on the \"Send a test email\" button."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"For more information on how to use the Handlebars to customise email\ntemplates, see our\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/references/email-templates/#handlebars"},"children":[{"type":"text","value":"reference article on email templates"}]},{"type":"text","value":"."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"h2","properties":{"id":"transaction-notifications","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#transaction-notifications","ariaLabel":"transaction notifications permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","height":"16","version":"1.1","viewBox":"0 0 16 16","width":"16"},"children":[{"type":"element","tagName":"path","properties":{"fillRule":"evenodd","d":"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"},"children":[]}]}]},{"type":"text","value":"Transaction notifications"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Transaction notifications inform the user of events related to the\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/concepts/transaction-process/"},"children":[{"type":"text","value":"transaction process"}]},{"type":"text","value":". These\nnotifications usually relate to information about bookings and payments,\nin contrast to built-in email notifications, which are typically\nactionable and related to account management."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"You can update, add, or delete transaction notifications by\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/how-to/edit-transaction-process-with-flex-cli/"},"children":[{"type":"text","value":"editing the transaction process"}]},{"type":"text","value":".\nThe\n"},{"type":"element","tagName":"a","properties":{"href":"https://github.com/sharetribe/example-processes/tree/master/flex-default-process/templates","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"template sub-directory"}]},{"type":"text","value":"\nin the transaction process directory contains all the transaction\nnotification email templates. All transaction notifications use the\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/references/email-templates/#handlebars"},"children":[{"type":"text","value":"Handlebars templating language"}]},{"type":"text","value":"\nand can be edited similarly to built-in email templates."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"In addition to making changes to the content of the transaction\nnotifications, you can change\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/references/transaction-process-time-expressions/"},"children":[{"type":"text","value":"when email notifications get sent"}]},{"type":"text","value":".\nA transaction notification must always be associated with a specific\ntransition. When a specific transition transitions, the transaction\nnotification associated with it is triggered."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Read more about transaction notifications in our\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/tutorial/add-new-email-notification/"},"children":[{"type":"text","value":"tutorial on how to add new email notifications"}]},{"type":"text","value":"."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"h2","properties":{"id":"custom-notifications-through-zapier","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#custom-notifications-through-zapier","ariaLabel":"custom notifications through zapier permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","height":"16","version":"1.1","viewBox":"0 0 16 16","width":"16"},"children":[{"type":"element","tagName":"path","properties":{"fillRule":"evenodd","d":"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"},"children":[]}]}]},{"type":"text","value":"Custom notifications through Zapier"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Sometimes the built-in and transaction notifications are not enough, and\nyou might need more control over what triggers an email. Examples\ninclude notifying your marketplace operators when a user submits a\nlisting for review or sending a provider an email once their listing is\npublished. As neither of these actions is transaction related, you can\nnot trigger them as transaction notifications. Instead, you must listen\nto events and trigger an email to respond to the correct event."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"For building custom email notifications, we recommend connecting your\napp to Zapier. You can use Zapier to listen for events in your\nmarketplace and react to them using different actions. Zapier also\nsupports sending text messages instead of emails. Read more about Zapier\nin our\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/how-to/set-up-and-use-zapier/"},"children":[{"type":"text","value":"guide on how to set up and use Zapier"}]},{"type":"text","value":"."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"If you are unsure how to approach a Zapier integration, do not hesitate\nto reach out to our support team through one of our\n"},{"type":"element","tagName":"a","properties":{"href":"https://www.sharetribe.com/support/","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"official support channels"}]},{"type":"text","value":". We\nwill be happy to help you figure out your specific use case and give you\nsome suggestions for implementation."}]}],"data":{"quirksMode":false}},"headings":[{"value":"Enable email notifications","depth":2},{"value":"Built-in email notifications","depth":2},{"value":"Transaction notifications","depth":2},{"value":"Custom notifications through Zapier","depth":2}]}},"pageContext":{"slug":"email-notifications","category":"concepts-messages"}},
    "staticQueryHashes": ["3794076007","439097193","717698143"]}