Skip to main content

Troubleshoot domain verification

Resolve pending DNS, file, or HTML meta-tag ownership verification for a public status page.

Ownership verification remains Pending when Uptime Basics cannot find the current token using the selected method. A pending result does not disable a basic status page, but branding, analytics, and custom-domain controls remain locked.

Check these items first

  1. Confirm the selected verification method is the one you completed.
  2. Wait until the method has saved and use the token currently displayed.
  3. Confirm you added the evidence to the exact hostname in the monitor URL.
  4. Make the record, file, or page publicly reachable without signing in.
  5. Select Check verification after making a correction.

Changing the method creates new instructions and a new token. An older DNS value, file, or meta tag will no longer match.

DNS TXT verification

  • Use the exact generated record name and token.
  • Check whether your DNS provider automatically adds the domain name.
  • Make sure the record is in the public authoritative DNS zone, not a private zone.
  • Wait for DNS propagation and the previous TTL when replacing a record.
  • Confirm a public TXT lookup returns the token as one complete value.

Quotation marks shown by a DNS provider are normally display formatting. Extra spaces or explanatory text inside the TXT value are not accepted.

Verification-file method

  • Publish the file at the exact HTTPS URL shown in the instructions.
  • Keep the fixed path /.well-known/uptimebasics-verification.txt.
  • Make the trimmed file body equal only the current token.
  • Remove authentication, redirects, bot challenges, and access rules from that file path.
  • Purge website or CDN caches after replacing the file.

Opening the URL in your own signed-in browser is not enough if an external request receives a different response.

HTML meta-tag method

  • Add the generated tag to the home page of the exact monitored origin.
  • Put it in the initial server-returned HTML, not through JavaScript.
  • Preserve the generated name and content values exactly.
  • Keep the tag near the beginning of the <head>.
  • Check whether an apex-to-www, HTTP-to-HTTPS, or regional redirect changes the page Uptime Basics receives.

Use View page source in a private window to inspect the response rather than relying only on the rendered DOM.

Use the verification record

The Ownership section shows the selected method, status, last check time, and verified time. After a failed check, the message above the editor explains the most recent problem, such as a missing TXT token, inaccessible file, or missing meta tag.

If the evidence is publicly visible and a new check still fails, contact support with the monitor URL, selected method, last checked time, and the exact error message. Do not send account passwords, authenticator codes, or unrelated secrets.

Related articles

Did this answer your question?

Your response helps improve this Help Center.