Public Sites troubleshooting
On this page
Find the message, then the cause. The words in quotes are the words on the screen.
A domain stays on Waiting for DNS
The records are missing, wrong, or still spreading. DNS changes can take up to an hour to show. Checks run every few minutes for 72 hours, and Check now asks immediately.
Open the domain card and read the red lines. Fix only the records it names, then click Check now. If you would rather not edit DNS yourself, click Ask the agent to set up DNS. See Custom domains and DNS.


Figure 1: The card lists each problem. Fix those records and click Check now
The TXT record is missing or wrong
"The TXT verification record is missing or has the wrong value."
The name has to be the relative name on the card, usually _ph-sites, not the full name. The value has to be the token on the card now. An old token, including one from a domain you removed and added again, will not verify. Copy it. Do not retype it.
The domain points somewhere else
"The domain points somewhere else: change its CNAME (or ALIAS / A) record to the value shown."
"The domain doesn't point anywhere yet: add the CNAME (or ALIAS / A) record."
Replace the CNAME, ALIAS, ANAME or A record with the value on the card. Leave every other record, especially email, as it is. If a proxy or traffic-routing switch is on for that record, turn it off so the record points straight at the site.
Not connected, after 72 hours
Not connected means the 72-hour window passed without valid records. The records can still be fixed. Check now still works after the window. Add the records shown on the card, wait for them to be visible, and click Check now.
Disconnected, after 14 days
Disconnected means the records have been missing for 14 days. The owner is notified. Add the domain again if you still want it. Adding it again creates a new verification token, so the TXT record has to be updated too.
The certificate is not issued
"The HTTPS certificate hasn't been issued yet. Check the domain still points at your site and that no CAA record blocks it."
"The domain's CAA records don't allow its certificate to be issued: add the CAA record shown."
The certificate comes from a public certificate authority, usually within a minute or two of the domain connecting. If it does not, the domain no longer points at the site, or a CAA record is blocking the authority. Point the domain at the value on the card, and add the CAA record the card shows. That record must allow a public certificate authority.
While it is working, the card says "Issuing the HTTPS certificate. This usually takes a minute or two."
This site is offline
"This site is offline" means the Agent or the app cannot be reached. Check that the Agent is online in Device management. For a Physical Agent (on-premise), check power and the facility's internet. See The hardware.
The first time any app on an Agent goes public, the Agent opens a separate outbound connection for visitors. The site can be unreachable for a minute or two while that happens. Wait and try again.
A paused app is different. Visitors see Site not found, not "This site is offline". The dialog shows "The app is paused, so its public site is offline until you resume it." Resume the app.


Figure 2: The app is paused. Resume it. Visitors currently see Site not found
This site isn't available yet
"This site isn't available yet" means a public-ready rule is failing on the running app. Open Public site. The dialog lists the problems. Click Ask the agent to fix these, then Check again. Put on the internet stays disabled until they are fixed, on a site that is not live yet. On a site that is already live, visitors see this page until the check passes again.


Figure 3: The rules that failed. Ask the Agent to fix them, then check again
A new address does not load
"If the address doesn't load yet, wait 30 seconds and try again. A new address can take a moment to reach every network."
Wait, then open it again. The same applies the first time the Agent starts its visitor connection.
Setting up the web address does not finish
"Setting up the web address. This usually takes under a minute."
If it does not finish, the dialog may also say "We couldn't set up the site's connection. Try again in a minute." Wait a minute and try again. If it still fails, check the Agent is online.
Site not found
"Site not found"
"There's no site at this address. Check the link, or ask the person who shared it."
The footer reads "Hosted on ph-sites.com · Report abuse".
This is also what a visitor sees when the app is paused, for a short time after you take a site off the internet, and when a sensitive path inside the app is blocked.


Figure 4: Site not found. Check the link, or whether the app is paused or taken off the internet
An old ph-sites.com address, after a rename, redirects to the new one for 30 days. After that it no longer resolves. Send the new address.
Wrong password, or too many attempts
"That password isn't right. Try again."
"Too many attempts. Try again in {n} minutes."
A visitor gets a few tries, then a delay that grows, up to 15 minutes. There is also a cap on attempts against the whole site. Wait for the time in the message. Entering a new password in the Public site dialog signs everyone out, and they need the new password.


Figure 5: A wrong password. Repeated attempts are slowed, then locked for the time shown
Email stopped working after a DNS change
The domain's nameservers were changed, or its MX records were edited or deleted. Put the nameservers and the email records back. Then add only the records shown on the domain card. See The records.
The bare domain fails, and www works
The bare domain is missing its ALIAS, ANAME or A record, or it still has an AAAA record. Add the apex record from the card, and remove AAAA records on that name. Prefer ALIAS, ANAME or CNAME flattening when the DNS host offers it.
That domain is connected to another site
"That domain is connected to another site."
"This domain is connected to another site."
A domain can be on one site only. Remove it from the other site, or unpublish that app, which disconnects its custom domains. Then add it here.
Public sites aren't available in this region yet
"Public sites aren't available in this AI Agent's region yet."
Nothing is wrong with the app or the DNS. Public sites are not available for this Agent's region yet. Contact Performance Hub support if you need the site on this Agent. Gateway regions are not listed here, and visitor traffic is not pinned to one region. See Cloud vs on-premise Agents.
Update the Agent
"Update the AI Agent to use this."
"Update the AI Agent to put apps on the internet."
The Agent's software needs the latest update. Apply it from Update now, or schedule it. See Software updates.
The site was suspended
"This site has been suspended"
Performance Hub has taken the site offline after a report. The owner is told to contact Performance Hub support. Abuse reports are made from the Report abuse link on ph-sites.com. The terms are at performancehub.co/legal.