Troubleshooting
Fix the most common problems in Sonat: find your symptom, see the cause, and follow the fix.
Can't find your problem here? See Get help to chat with us or report a bug.
Readers can't see my topic
Cause: Readers only see published topics. A new topic, or new changes to an existing one, stay in draft until you publish. If your document needs approval, the changes wait in a publish request until a reviewer approves them.
Fix:
- Open the topic and select Publish.
- If a publish request opens instead, ask the reviewers to approve it.
- Reload the reader page. If the topic is in a private document, sign in as a reader who has access.
See Publish and preview and Publish requests.
Reader search finds nothing
Cause: Reader search is part of Team and above. On Free, readers can't search your help center. On a paid plan, content you published before search was turned on may not be indexed yet.
Fix:
- Check your plan on Billing › Plan. Upgrade to Team or above if you're on Free.
- Open Organization Settings › Search and run the initial indexing if Sonat says Existing content is not indexed yet.
- Wait for indexing to finish. It continues in the background, so you can close the tab and check again later.
See Reader search.
My custom domain doesn't work
Cause: Your domain's DNS record is missing, wrong, or hasn't spread across the internet yet.
Fix:
- Open Organization Settings › Custom Domain and check the record Sonat asks for: an A record at the root (
@) for a root domain, or a CNAME record for a subdomain such asdocs.example.com. - At your DNS provider, compare the record with what Sonat shows. Fix any typo in the name or value.
- Wait a few minutes, then select Refresh.
- When Sonat says You're ready to go!, give the domain a few more minutes to become fully active.
See Custom domain.
Changes in my Google Doc don't show up for readers
Cause: Edits in Google Docs update the topic's draft in Sonat. Readers only see them after you publish in Sonat. If the topic says Google Doc Connection Lost, the Google Doc was deleted or its sharing changed.
Fix:
- Open the topic in Sonat and publish it.
- If you see Google Doc Connection Lost, select Reconnect Google Doc and pick the right file.
- Check that the Google Drive connection is still in place in Organization Settings › Google Drive Integration.
See How Google Docs editing works.
The PDF export looks wrong or out of date
Cause: Sonat rebuilds the PDF when you publish, so unpublished changes aren't in it. A custom cover page or physical tabs only appear when the addons that add them are installed.
Fix:
- Publish the topics you changed, then download the PDF again.
- Check the document's PDF export settings: header, footer and cover page.
- For a custom cover page or physical tabs, install Custom PDF Cover Page or Physical Tabs. They need Business and above, or Team with the Custom PDF layout extra.
See Export to PDF.
"You've used this month's AI credits"
Cause: Your organization has used its AI credits. On Free, the 300 credits are a one-time allowance. On paid plans, credits renew each month.
Fix:
- Free: upgrade to Team for a monthly allowance. Select See plans.
- Paid plans: wait for the renewal date shown in the message, or ask your owner to buy a credit pack on Billing › Plan.
- Not the owner? Ask your organization's owner. Only the owner can upgrade or buy credits.
See AI credits.
A reader can't open a private document
Cause: The reader isn't on the document's reader list, isn't signed in with an email from an allowed domain, or is using a share link that doesn't grant this document.
Fix:
- Open the document's Private Document page, or Private Organization for the whole help center.
- Under Who can read, add the reader's email, add their company domain, or give a share link access to this document.
- Ask the reader to sign in with the exact email you added.
See Private documents.
I can't install an addon
Cause: Only an Owner or Admin can install addons. Some addons need a higher plan or an organization setting turned on first.
Fix:
- Hover over the grayed-out Install button to read the reason.
- If it says Not included in your current plan, upgrade. See Plans and limits.
- If it says Turn on the required organization setting first, turn on Document Export in Organization Settings › Advanced.
- If you aren't an Owner or Admin, ask one to install it.
See Addons.
The person I invited didn't get the email
Cause: The invitation went to spam, or the email address has a typo.
Fix:
- Ask them to check their spam or junk folder for an email from Sonat.
- Open Manage Team and check the address. If it's wrong, remove the person and invite the right address.
- Ask them to sign up at editor.sonat.com with the invited email. Their access is waiting for that address.
See Invite your team.