[{"data":1,"prerenderedAt":640},["ShallowReactive",2],{"docs-navigation":3,"\u002Fdocs\u002Fdomains\u002Ftroubleshooting":202,"\u002Fdocs\u002Fdomains\u002Ftroubleshooting-surround":635},[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":33,"body":204,"description":628,"extension":629,"links":630,"meta":631,"navigation":632,"path":34,"seo":633,"stem":35,"__hash__":634},"docs\u002Fdocs\u002F2.domains\u002F2.troubleshooting.md",{"type":205,"value":206,"toc":615},"minimark",[207,216,221,233,325,328,332,339,345,349,360,363,430,451,455,458,471,475,478,491,495,508,521,525,532,538,549,553,562,578,582,587,591,598,602,611],[208,209,210,211,215],"p",{},"Each check on the domain card in ",[212,213,214],"strong",{},"Settings › Domains"," comes with a message, such as \"Return path: the MX record of bounce.acme.com is not published yet\". Find the matching symptom below.",[217,218,220],"h2",{"id":219},"check-the-records-yourself","Check the records yourself",[208,222,223,224,228,229,232],{},"Before changing anything, query public DNS with ",[225,226,227],"code",{},"dig"," (replace ",[225,230,231],{},"acme.com"," and the DKIM token):",[234,235,240],"pre",{"className":236,"code":237,"language":238,"meta":239,"style":239},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","dig +short CNAME abc123._domainkey.acme.com   # → abc123.dkim.amazonses.com.\ndig +short MX bounce.acme.com                 # → 10 feedback-smtp.eu-west-3.amazonses.com.\ndig +short TXT bounce.acme.com                # → \"v=spf1 include:amazonses.com ~all\"\ndig +short TXT _dmarc.acme.com                # → \"v=DMARC1; p=none;\"\ndig +short CNAME link.acme.com                # → track.kulamail.com.\n","bash","",[225,241,242,264,280,295,310],{"__ignoreMap":239},[243,244,247,250,254,257,260],"span",{"class":245,"line":246},"line",1,[243,248,227],{"class":249},"sBMFI",[243,251,253],{"class":252},"sfazB"," +short",[243,255,256],{"class":252}," CNAME",[243,258,259],{"class":252}," abc123._domainkey.acme.com",[243,261,263],{"class":262},"sHwdD","   # → abc123.dkim.amazonses.com.\n",[243,265,267,269,271,274,277],{"class":245,"line":266},2,[243,268,227],{"class":249},[243,270,253],{"class":252},[243,272,273],{"class":252}," MX",[243,275,276],{"class":252}," bounce.acme.com",[243,278,279],{"class":262},"                 # → 10 feedback-smtp.eu-west-3.amazonses.com.\n",[243,281,283,285,287,290,292],{"class":245,"line":282},3,[243,284,227],{"class":249},[243,286,253],{"class":252},[243,288,289],{"class":252}," TXT",[243,291,276],{"class":252},[243,293,294],{"class":262},"                # → \"v=spf1 include:amazonses.com ~all\"\n",[243,296,298,300,302,304,307],{"class":245,"line":297},4,[243,299,227],{"class":249},[243,301,253],{"class":252},[243,303,289],{"class":252},[243,305,306],{"class":252}," _dmarc.acme.com",[243,308,309],{"class":262},"                # → \"v=DMARC1; p=none;\"\n",[243,311,313,315,317,319,322],{"class":245,"line":312},5,[243,314,227],{"class":249},[243,316,253],{"class":252},[243,318,256],{"class":252},[243,320,321],{"class":252}," link.acme.com",[243,323,324],{"class":262},"                # → track.kulamail.com.\n",[208,326,327],{},"An empty answer means the record isn't published, or not under that name. No terminal at hand? Any online \"DNS lookup\" tool gives the same answer.",[217,329,331],{"id":330},"the-record-was-just-added","The record was just added",[208,333,334,335,338],{},"DNS changes usually spread in a few minutes, sometimes up to an hour, rarely more. Kula keeps checking on its own (every 15 minutes at first). Click ",[212,336,337],{},"Check now"," to force a check.",[208,340,341,342,344],{},"If ",[225,343,227],{}," shows the right value and the check is still pending after an hour, contact support.",[217,346,348],{"id":347},"the-domain-appears-twice-in-the-name","The domain appears twice in the name",[208,350,351,352,355,356,359],{},"Many DNS providers append your domain to every name you type. If you enter ",[225,353,354],{},"bounce.acme.com",", the record ends up on ",[225,357,358],{},"bounce.acme.com.acme.com"," and the check never finds it.",[208,361,362],{},"Enter only the part before your domain:",[364,365,366,379],"table",{},[367,368,369],"thead",{},[370,371,372,376],"tr",{},[373,374,375],"th",{},"Kula shows",[373,377,378],{},"Enter at such providers",[380,381,382,395,406,418],"tbody",{},[370,383,384,390],{},[385,386,387],"td",{},[225,388,389],{},"abc123._domainkey.acme.com",[385,391,392],{},[225,393,394],{},"abc123._domainkey",[370,396,397,401],{},[385,398,399],{},[225,400,354],{},[385,402,403],{},[225,404,405],{},"bounce",[370,407,408,413],{},[385,409,410],{},[225,411,412],{},"_dmarc.acme.com",[385,414,415],{},[225,416,417],{},"_dmarc",[370,419,420,425],{},[385,421,422],{},[225,423,424],{},"link.acme.com",[385,426,427],{},[225,428,429],{},"link",[208,431,432,433,436,437,439,440,443,444,443,447,450],{},"When you send from a subdomain such as ",[225,434,435],{},"mail.acme.com"," and your DNS zone is ",[225,438,231],{},", keep the subdomain part: ",[225,441,442],{},"bounce.mail",", ",[225,445,446],{},"link.mail",[225,448,449],{},"_dmarc.mail",".",[217,452,454],{"id":453},"cloudflare-the-tracking-or-dkim-check-fails","Cloudflare: the tracking or DKIM check fails",[208,456,457],{},"Cloudflare proxies CNAME records by default (orange cloud). A proxied CNAME answers with Cloudflare's own addresses instead of the target, so the check sees a wrong value.",[208,459,460,461,463,464,467,468,470],{},"Set the DKIM and ",[225,462,429],{}," records to ",[212,465,466],{},"DNS only"," (grey cloud). The tracking subdomain needs it too: Kula issues the HTTPS certificate for ",[225,469,424],{}," itself, which doesn't work behind Cloudflare's proxy.",[217,472,474],{"id":473},"points-to-the-wrong-value","\"Points to the wrong value\"",[208,476,477],{},"The record exists but its value doesn't match. Common causes:",[479,480,481,485,488],"ul",{},[482,483,484],"li",{},"a typo, or a value cut short when copying: use the copy buttons in Kula;",[482,486,487],{},"a trailing dot or quotes added by hand in a field that doesn't expect them;",[482,489,490],{},"an old record left over from a previous email tool, under the same name. Delete it and keep only Kula's.",[217,492,494],{"id":493},"you-already-have-an-spf-record","You already have an SPF record",[208,496,497,498,500,501,503,504,507],{},"Kula's SPF record goes on ",[225,499,354],{},", not on ",[225,502,231],{},". Your main domain's SPF record (for Google Workspace, Microsoft 365…) stays as it is, and you don't need to add ",[225,505,506],{},"amazonses.com"," to it.",[208,509,341,510,512,513,516,517,520],{},[225,511,354],{}," already has a TXT record starting with ",[225,514,515],{},"v=spf1",", it must include ",[225,518,519],{},"include:amazonses.com",". A name can only have one SPF record: merge them rather than adding a second.",[217,522,524],{"id":523},"you-already-have-a-dmarc-record","You already have a DMARC record",[208,526,527,528,531],{},"Keep it. Kula accepts any valid record starting with ",[225,529,530],{},"v=DMARC1",", on the sending domain or, for a subdomain, on the main domain.",[533,534,535],"warning",{},[208,536,537],{},"Never publish two DMARC records on the same name. Inbox providers then ignore both, and the domain has no DMARC at all.",[208,539,540,541,544,545,548],{},"A strict policy (",[225,542,543],{},"p=quarantine"," or ",[225,546,547],{},"p=reject",") works too: emails sent through Kula pass DKIM with your domain, so they're aligned.",[217,550,552],{"id":551},"the-return-path-mx-conflicts-with-another-record","The return path MX conflicts with another record",[208,554,555,556,558,559,561],{},"The MX record goes on ",[225,557,354],{},", a subdomain only used for bounces. It never replaces the MX of ",[225,560,231],{},", so your mailbox keeps receiving email.",[208,563,564,565,567,568,571,572,574,575,577],{},"If the check says the MX of ",[225,566,354],{}," must point to ",[225,569,570],{},"feedback-smtp.eu-west-3.amazonses.com",", another MX already exists on that name. Delete it: nothing else should receive mail on ",[225,573,354],{},". Some providers also refuse a CNAME and an MX on the same name; ",[225,576,405],{}," needs only the MX and the TXT.",[217,579,581],{"id":580},"the-domain-was-verified-and-is-now-pending","The domain was verified and is now pending",[208,583,584,585,450],{},"Kula checks verified domains every day. A record has disappeared, often after moving the domain to another DNS provider or cleaning up the zone. Sending from this domain stops until it's back. Publish the missing record again and click ",[212,586,337],{},[217,588,590],{"id":589},"already-used-by-another-space","\"Already used by another space\"",[208,592,593,594,597],{},"A domain belongs to a single space. Remove it from the other space first, or use a different subdomain, such as ",[225,595,596],{},"news.acme.com",", for the second space.",[217,599,601],{"id":600},"still-stuck","Still stuck?",[208,603,604,605,610],{},"Write to ",[606,607,609],"a",{"href":608},"mailto:support@kulamail.com","support@kulamail.com"," with your domain name.",[612,613,614],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":239,"searchDepth":246,"depth":266,"links":616},[617,618,619,620,621,622,623,624,625,626,627],{"id":219,"depth":266,"text":220},{"id":330,"depth":266,"text":331},{"id":347,"depth":266,"text":348},{"id":453,"depth":266,"text":454},{"id":473,"depth":266,"text":474},{"id":493,"depth":266,"text":494},{"id":523,"depth":266,"text":524},{"id":551,"depth":266,"text":552},{"id":580,"depth":266,"text":581},{"id":589,"depth":266,"text":590},{"id":600,"depth":266,"text":601},"Fix a DNS check that stays pending or fails","md",null,{},true,{"title":33,"description":628},"PTxTeiSMsTPcqcq32tM3yNRHww_DwK7cYoU7dYwis5g",[636,638],{"title":29,"path":30,"stem":31,"description":637,"children":-1},"How to configure your DNS",{"title":42,"path":43,"stem":44,"description":639,"children":-1},"Contact fields, attributes, statuses and sources",1792265663024]