[{"data":1,"prerenderedAt":642},["ShallowReactive",2],{"docs-navigation":3,"\u002Fdocs\u002Femails\u002Fwriting-emails":202,"\u002Fdocs\u002Femails\u002Fwriting-emails-surround":637},[4],{"title":5,"path":6,"stem":7,"children":8,"page":22},"Docs","\u002Fdocs","docs",[9,23,36,65,86,115,128,172,185],{"title":10,"path":11,"stem":12,"children":13,"page":22},"Getting started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[14,18],{"title":15,"path":16,"stem":17},"Quickstart","\u002Fdocs\u002Fgetting-started\u002Fquickstart","docs\u002F1.getting-started\u002F1.quickstart",{"title":19,"path":20,"stem":21},"Concepts","\u002Fdocs\u002Fgetting-started\u002Fconcepts","docs\u002F1.getting-started\u002F2.concepts",false,{"title":24,"path":25,"stem":26,"children":27,"page":22},"Sending domain","\u002Fdocs\u002Fdomains","docs\u002F2.domains",[28,32],{"title":29,"path":30,"stem":31},"Add your domain","\u002Fdocs\u002Fdomains\u002Fadd-your-domain","docs\u002F2.domains\u002F1.add-your-domain",{"title":33,"path":34,"stem":35},"Troubleshooting","\u002Fdocs\u002Fdomains\u002Ftroubleshooting","docs\u002F2.domains\u002F2.troubleshooting",{"title":37,"path":38,"stem":39,"children":40,"page":22},"Audience","\u002Fdocs\u002Faudience","docs\u002F3.audience",[41,45,49,53,57,61],{"title":42,"path":43,"stem":44},"Contacts","\u002Fdocs\u002Faudience\u002Fcontacts","docs\u002F3.audience\u002F1.contacts",{"title":46,"path":47,"stem":48},"Import contacts","\u002Fdocs\u002Faudience\u002Fimport","docs\u002F3.audience\u002F2.import",{"title":50,"path":51,"stem":52},"Lists","\u002Fdocs\u002Faudience\u002Flists","docs\u002F3.audience\u002F3.lists",{"title":54,"path":55,"stem":56},"Segments","\u002Fdocs\u002Faudience\u002Fsegments","docs\u002F3.audience\u002F4.segments",{"title":58,"path":59,"stem":60},"Signup forms","\u002Fdocs\u002Faudience\u002Fsignup-forms","docs\u002F3.audience\u002F5.signup-forms",{"title":62,"path":63,"stem":64},"Unsubscribe and preferences","\u002Fdocs\u002Faudience\u002Funsubscribe-and-preferences","docs\u002F3.audience\u002F6.unsubscribe-and-preferences",{"title":66,"path":67,"stem":68,"children":69,"page":22},"Sending emails","\u002Fdocs\u002Femails","docs\u002F4.emails",[70,74,78,82],{"title":71,"path":72,"stem":73},"Writing emails","\u002Fdocs\u002Femails\u002Fwriting-emails","docs\u002F4.emails\u002F1.writing-emails",{"title":75,"path":76,"stem":77},"Campaigns","\u002Fdocs\u002Femails\u002Fcampaigns","docs\u002F4.emails\u002F2.campaigns",{"title":79,"path":80,"stem":81},"Flows","\u002Fdocs\u002Femails\u002Fflows","docs\u002F4.emails\u002F3.flows",{"title":83,"path":84,"stem":85},"Transactional emails","\u002Fdocs\u002Femails\u002Ftransactional","docs\u002F4.emails\u002F4.transactional",{"title":87,"path":88,"stem":89,"children":90,"page":22},"Deliverability","\u002Fdocs\u002Fdeliverability","docs\u002F5.deliverability",[91,95,99,103,107,111],{"title":92,"path":93,"stem":94},"Overview","\u002Fdocs\u002Fdeliverability\u002Foverview","docs\u002F5.deliverability\u002F1.overview",{"title":96,"path":97,"stem":98},"Warm-up","\u002Fdocs\u002Fdeliverability\u002Fwarm-up","docs\u002F5.deliverability\u002F2.warm-up",{"title":100,"path":101,"stem":102},"Contacts under review","\u002Fdocs\u002Fdeliverability\u002Fimported-contacts","docs\u002F5.deliverability\u002F3.imported-contacts",{"title":104,"path":105,"stem":106},"Reputation","\u002Fdocs\u002Fdeliverability\u002Freputation","docs\u002F5.deliverability\u002F4.reputation",{"title":108,"path":109,"stem":110},"Bounces and suppressions","\u002Fdocs\u002Fdeliverability\u002Fbounces-and-suppressions","docs\u002F5.deliverability\u002F5.bounces-and-suppressions",{"title":112,"path":113,"stem":114},"Deliverability report","\u002Fdocs\u002Fdeliverability\u002Fdeliverability-report","docs\u002F5.deliverability\u002F6.deliverability-report",{"title":116,"path":117,"stem":118,"children":119,"page":22},"AI","\u002Fdocs\u002Fai","docs\u002F6.ai",[120,124],{"title":121,"path":122,"stem":123},"Assistant","\u002Fdocs\u002Fai\u002Fassistant","docs\u002F6.ai\u002F1.assistant",{"title":125,"path":126,"stem":127},"Connect your agent (MCP)","\u002Fdocs\u002Fai\u002Fmcp","docs\u002F6.ai\u002F2.mcp",{"title":129,"path":130,"stem":131,"children":132,"page":22},"API reference","\u002Fdocs\u002Fapi","docs\u002F7.api",[133,137,141,145,148,152,156,160,164,168],{"title":134,"path":135,"stem":136},"Introduction","\u002Fdocs\u002Fapi\u002Fintroduction","docs\u002F7.api\u002F01.introduction",{"title":138,"path":139,"stem":140},"Emails","\u002Fdocs\u002Fapi\u002Femails","docs\u002F7.api\u002F02.emails",{"title":142,"path":143,"stem":144},"Templates","\u002Fdocs\u002Fapi\u002Ftemplates","docs\u002F7.api\u002F03.templates",{"title":42,"path":146,"stem":147},"\u002Fdocs\u002Fapi\u002Fcontacts","docs\u002F7.api\u002F04.contacts",{"title":149,"path":150,"stem":151},"Events","\u002Fdocs\u002Fapi\u002Fevents","docs\u002F7.api\u002F05.events",{"title":153,"path":154,"stem":155},"Lists and segments","\u002Fdocs\u002Fapi\u002Flists-and-segments","docs\u002F7.api\u002F06.lists-and-segments",{"title":157,"path":158,"stem":159},"Campaigns and flows","\u002Fdocs\u002Fapi\u002Fcampaigns-and-flows","docs\u002F7.api\u002F07.campaigns-and-flows",{"title":161,"path":162,"stem":163},"Domains and suppressions","\u002Fdocs\u002Fapi\u002Fdomains-and-suppressions","docs\u002F7.api\u002F08.domains-and-suppressions",{"title":165,"path":166,"stem":167},"Spaces","\u002Fdocs\u002Fapi\u002Fspaces","docs\u002F7.api\u002F09.spaces",{"title":169,"path":170,"stem":171},"Webhooks","\u002Fdocs\u002Fapi\u002Fwebhooks","docs\u002F7.api\u002F10.webhooks",{"title":173,"path":174,"stem":175,"children":176,"page":22},"Account & billing","\u002Fdocs\u002Faccount","docs\u002F8.account",[177,181],{"title":178,"path":179,"stem":180},"Spaces and members","\u002Fdocs\u002Faccount\u002Fspaces-and-members","docs\u002F8.account\u002F1.spaces-and-members",{"title":182,"path":183,"stem":184},"Billing","\u002Fdocs\u002Faccount\u002Fbilling","docs\u002F8.account\u002F2.billing",{"title":186,"path":187,"stem":188,"children":189,"page":22},"Guides","\u002Fdocs\u002Fguides","docs\u002F9.guides",[190,194,198],{"title":191,"path":192,"stem":193},"Welcome new subscribers","\u002Fdocs\u002Fguides\u002Fwelcome-sequence","docs\u002F9.guides\u002F1.welcome-sequence",{"title":195,"path":196,"stem":197},"Onboarding with events","\u002Fdocs\u002Fguides\u002Fonboarding-with-events","docs\u002F9.guides\u002F2.onboarding-with-events",{"title":199,"path":200,"stem":201},"Migrate from another tool","\u002Fdocs\u002Fguides\u002Fmigrate-from-another-tool","docs\u002F9.guides\u002F3.migrate-from-another-tool",{"id":203,"title":71,"body":204,"description":630,"extension":631,"links":632,"meta":633,"navigation":634,"path":72,"seo":635,"stem":73,"__hash__":636},"docs\u002Fdocs\u002F4.emails\u002F1.writing-emails.md",{"type":205,"value":206,"toc":621},"minimark",[207,211,216,257,281,300,304,310,358,372,376,383,393,494,525,529,532,582,589,595,599],[208,209,210],"p",{},"Campaigns, flow emails and transactional templates share the same editor and design. Kula wraps the content in your brand, personalizes it for each recipient and adds the plain-text version, tracking and unsubscribe links.",[212,213,215],"h2",{"id":214},"the-editor","The editor",[217,218,219,232],"table",{},[220,221,222],"thead",{},[223,224,225,229],"tr",{},[226,227,228],"th",{},"Mode",[226,230,231],{},"Best for",[233,234,235,247],"tbody",{},[223,236,237,244],{},[238,239,240],"td",{},[241,242,243],"strong",{},"Visual",[238,245,246],{},"Most emails. Headings, bold, lists, quotes, links, images and dividers, wrapped in your email design. Stored as Markdown, so AI assistants and the API can write it too.",[223,248,249,254],{},[238,250,251],{},[241,252,253],{},"HTML",[238,255,256],{},"Emails designed elsewhere, or full control over the layout. Sent as you write it, without the email design.",[208,258,259,260,263,264,267,268,271,272,275,276,280],{},"Use ",[241,261,262],{},"Preview"," to check the email on ",[241,265,266],{},"Desktop"," and ",[241,269,270],{},"Mobile",", and ",[241,273,274],{},"Send test"," to receive it in a real inbox. Test emails go to up to 5 addresses, with ",[277,278,279],"code",{},"[Test]"," in front of the subject, and are not tracked.",[282,283,284],"tip",{},[208,285,286,287,290,291,294,295,299],{},"Through the API, send ",[277,288,289],{},"contentFormat: \"MARKDOWN\""," with Markdown content, or ",[277,292,293],{},"\"HTML\""," with your own HTML. ",[296,297,298],"a",{"href":158},"Campaigns API",".",[212,301,303],{"id":302},"email-design","Email design",[208,305,306,309],{},[241,307,308],{},"Settings › Email design"," sets the look of every email written in the visual editor: campaigns, flows and transactional templates.",[217,311,312,322],{},[220,313,314],{},[223,315,316,319],{},[226,317,318],{},"Setting",[226,320,321],{},"Notes",[233,323,324,334,348],{},[223,325,326,331],{},[238,327,328],{},[241,329,330],{},"Brand color",[238,332,333],{},"Links and buttons",[223,335,336,341],{},[238,337,338],{},[241,339,340],{},"Logo URL",[238,342,343,344,347],{},"A PNG or JPG over ",[277,345,346],{},"https:\u002F\u002F",", about 300 px wide. Leave empty for no logo",[223,349,350,355],{},[238,351,352],{},[241,353,354],{},"Footer",[238,356,357],{},"Markdown. Put your postal address here: anti-spam laws require it in marketing emails",[208,359,360,361,267,364,367,368,371],{},"Marketing emails end with ",[241,362,363],{},"Unsubscribe",[241,365,366],{},"Manage preferences"," links under your footer. ",[241,369,370],{},"Send a test"," on the design page shows the result in your inbox.",[212,373,375],{"id":374},"variables","Variables",[208,377,378,379,382],{},"Click ",[241,380,381],{},"Insert variable"," in the editor, or type them:",[384,385,391],"pre",{"className":386,"code":388,"language":389,"meta":390},[387],"language-text","Hi {{ contact.first_name | default: \"there\" }},\n","text","",[277,392,388],{"__ignoreMap":390},[217,394,395,405],{},[220,396,397],{},[223,398,399,402],{},[226,400,401],{},"Variable",[226,403,404],{},"Value",[233,406,407,417,431,447,464,474,484],{},[223,408,409,414],{},[238,410,411],{},[277,412,413],{},"{{ contact.email }}",[238,415,416],{},"The recipient's address",[223,418,419,428],{},[238,420,421,424,425],{},[277,422,423],{},"{{ contact.first_name }}",", ",[277,426,427],{},"{{ contact.last_name }}",[238,429,430],{},"Name of the contact",[223,432,433,438],{},[238,434,435],{},[277,436,437],{},"{{ contact.\u003Cattribute> }}",[238,439,440,441,424,444],{},"Any attribute: ",[277,442,443],{},"{{ contact.plan }}",[277,445,446],{},"{{ contact.company }}",[223,448,449,454],{},[238,450,451],{},[277,452,453],{},"{{ data.\u003Ckey> }}",[238,455,456,457,460,461],{},"Variables sent with a ",[296,458,459],{"href":84},"transactional email",": ",[277,462,463],{},"{{ data.reset_url }}",[223,465,466,471],{},[238,467,468],{},[277,469,470],{},"{{ space.name }}",[238,472,473],{},"The name of your space",[223,475,476,481],{},[238,477,478],{},[277,479,480],{},"{{ unsubscribe_url }}",[238,482,483],{},"The recipient's unsubscribe link (marketing emails)",[223,485,486,491],{},[238,487,488],{},[277,489,490],{},"{{ preferences_url }}",[238,492,493],{},"The recipient's preferences page",[495,496,497,505,511,522],"ul",{},[498,499,500,501,504],"li",{},"An unknown variable or an empty value renders as nothing. Add ",[277,502,503],{},"| default: \"…\""," to show a fallback instead.",[498,506,507,508,299],{},"Dotted paths read nested values: ",[277,509,510],{},"{{ data.order.total }}",[498,512,513,514,517,518,521],{},"Values are escaped, so a name containing ",[277,515,516],{},"\u003C"," or ",[277,519,520],{},"&"," cannot break your HTML.",[498,523,524],{},"Variables only insert values. There are no conditions, loops or other filters: for logic, prepare the text in your app and send it as a variable.",[212,526,528],{"id":527},"what-kula-does-before-sending","What Kula does before sending",[208,530,531],{},"For each recipient, Kula:",[533,534,535,541,558,568,574],"ol",{},[498,536,537,540],{},[241,538,539],{},"Fills in the variables"," with the contact's data.",[498,542,543,546,547,550,551,554,555,299],{},[241,544,545],{},"Rewrites links"," so clicks are counted, through your tracking subdomain: ",[277,548,549],{},"https:\u002F\u002Flink.acme.com\u002Fc\u002F…",". The reader lands on the original URL. Turn click tracking off in ",[241,552,553],{},"Settings › General"," with ",[241,556,557],{},"Track clicks",[498,559,560,563,564,567],{},[241,561,562],{},"Adds a 1×1 pixel"," to count opens, if ",[241,565,566],{},"Track opens"," is on.",[498,569,570,573],{},[241,571,572],{},"Adds a plain-text version",", made from your content. Some mailbox providers reject HTML-only emails, and it helps deliverability everywhere.",[498,575,576,579,580,299],{},[241,577,578],{},"Adds the unsubscribe headers and links"," on marketing emails. ",[296,581,62],{"href":63},[208,583,584,585,588],{},"Opens and clicks made by machines (Apple Mail Privacy Protection, link scanners of company mailboxes) are recorded but flagged: they do not count as engagement and never lift the ",[296,586,587],{"href":101},"review"," of a contact.",[590,591,592],"note",{},[208,593,594],{},"Opens are an estimate: some mail clients block images, and Apple Mail loads them for every email. Clicks are a more reliable signal.",[212,596,598],{"id":597},"related","Related",[600,601,602,609,615],"card-group",{},[603,604,606],"card",{"icon":605,"title":75,"to":76},"i-mingcute-mail-send-fill",[208,607,608],{},"One-off emails to a list",[603,610,612],{"icon":611,"title":79,"to":80},"i-mingcute-git-merge-fill",[208,613,614],{},"Automated sequences",[603,616,618],{"icon":617,"title":83,"to":84},"i-mingcute-terminal-box-fill",[208,619,620],{},"Emails sent by your app",{"title":390,"searchDepth":622,"depth":623,"links":624},1,2,[625,626,627,628,629],{"id":214,"depth":623,"text":215},{"id":302,"depth":623,"text":303},{"id":374,"depth":623,"text":375},{"id":527,"depth":623,"text":528},{"id":597,"depth":623,"text":598},"The editor, email design, variables and what Kula adds before sending","md",null,{},true,{"title":71,"description":630},"58b5xT94YLRvMzg7sXWH3a5W4eJi1htz64kIChW_ykw",[638,640],{"title":62,"path":63,"stem":64,"description":639,"children":-1},"Unsubscribe links, one-click headers and the preferences page",{"title":75,"path":76,"stem":77,"description":641,"children":-1},"Send a one-off email to a list",1792265663372]