---
title: Troubleshooting
path: troubleshooting
status: published
---

# Troubleshooting

Symptoms and fixes for the things that actually go wrong. New pages get added here as the team accumulates real reports.

If your symptom matches one of these, jump to the page. If it doesn't, [Error Codes](../reference/error-codes.md) covers what every status code and message means and is the right starting point for "what does this error tell me?"

## What's here

Nothing yet — this section is the seed for symptom-driven troubleshooting pages. Add a page per recurring user-reported issue, named after the symptom (`record-not-resolving`, `dnssec-validation-failure`, `webhook-events-missing`).

## Common starting points elsewhere

- [Errors concept](../concepts/errors.md) — error response shape, retry/idempotency guidance.
- [Error Codes reference](../reference/error-codes.md) — every code and message.
- [Domain Validation concept](../concepts/validation.md) — the validation failure section covers the common cases.
- [DNSSEC tutorial](../tutorials/enable-dnssec.md) — the troubleshooting table at the bottom covers chain-of-trust issues.