Skip to content
Open console

CAA Records

A CAA record lists the certificate authorities allowed to issue certificates for your domain. Certificate authorities check this policy before issuing a certificate.

FieldExampleNotes
Name@Usually the apex. Applies to the domain and below.
TypeCAA
Content0 issue "letsencrypt.org"Flags, tag, and value.
TTL14400Seconds.

The value has three parts: flags (usually 0), a tag (issue, issuewild, or iodef), and a quoted value (the CA’s domain, or a contact URL for iodef).

CLI (wrap the value so the quotes reach the record):

zcp dns record-create --domain examplecom --name @ --type CAA --content '0 issue "letsencrypt.org"'

API: POST with { "name": "@", "type": "CAA", "content": "0 issue \"letsencrypt.org\"", "ttl": 14400 }.

dig CAA example.com +short
# 0 issue "letsencrypt.org"
  • issue allows a CA to issue non-wildcard certificates. issuewild covers wildcard certificates. iodef sets a contact for policy-violation reports.
  • No CAA record means no restriction. Without a CAA record, no policy restricts certificate issuance.

See also: TXT records, Worked examples, Record types

Ask the ZCP docs

Type a question and pick an assistant. The assistant opens in a new tab and reads this page and the full ZCP documentation, so its answer comes from our docs.

Example questions

Ask with

Your question goes to the assistant you pick, under its own terms.