Blog · Guide ·
How to publish SO4AG files on your website after a free audit
Run a free SOQVER audit, confirm your business facts, and learn where to upload each file on your website and how to verify its placement.
Who this path is for
If you manage a custom or older website and can upload files to it, you can publish your business facts directly on your domain. The free SOQVER audit prepares the files, so you can use the publishing tools you already have. If someone else manages the site, you can review and confirm the facts, then hand the package to them for upload.
The files use SO4AG, an open format for business facts and a working draft at version 0.1. Each fact records its conditions, its last valid day, and the public page where the business states it. A missing fact can be marked not stated. These details give a program less room to misread a price, a delivery term, or a booking rule.
Run the audit and read the result
- Enter your website address in the free website audit. The audit reads a few public pages from your site.
- Confirm your email address to open the result. The audit scores five areas: completeness, unambiguity, freshness, machine readability, and corroboration. The score measures how readily your facts can be found and read.
- Start with findings where a missing detail could change what a customer expects to pay or what they need to do. Check the public page that states the fact and make sure the wording includes the relevant conditions.
An example finding for Example Plumbing, at exampleplumbing.example, could be that its pricing page gives a service price without saying which service area it covers. If the price applies only within one city, make that clear on the pricing page and in the fact you confirm. If the page gives a starting price, keep that qualification in both places.
Before downloading the package, review the facts SOQVER drafted from your public website. Check each value against its source page, including who or what it applies to and its last valid day. Confirm the facts once they are accurate. Your business makes those statements and stands behind them.
Put each file in the right place
The audit package contains five items. Use the ready page or the standalone JSON-LD block according to how you manage pages on your site.
| Package item | Where it goes |
|---|---|
so4ag.json | Upload it to the root of your site so it is publicly available at /so4ag.json on your domain. Keep the filename as supplied. |
| Ready Facts and terms page | Publish it as a page on your site. It already contains the facts in JSON-LD, a form programs can read within the page. |
| Standalone JSON-LD block | If you build the Facts and terms page in your own template, add this block to that page. Use the same facts in the visible page content. |
llms.txt | If you already publish an llms.txt file, add only the facts section from the package to your existing file. If you need to place a new file, follow the package instructions. |
| Instructions | Keep these with the package as a reference for uploading the files and checking their placement. |
Once the files are up, open the public Facts and terms page and check that the terms match what you confirmed. If you handed the files to a web administrator, ask them to give you the public page address when they finish.
Verify placement and set a reminder
Return to the audit page and select Verify placement. The check reads so4ag.json from your domain. If it cannot read the file, open /so4ag.json on your site and check that the upload went to the root and kept the supplied filename. Then run the check again.
Facts in the audit package carry dates of at most 60 days. After a fact's last valid day, a program treats it as history. Use the earliest date in your package to set a reminder before it passes. When the reminder comes up, check the current terms on your website, review and confirm the facts again, and create a fresh package. You can do this for free. Upload the refreshed files and verify their placement again.
When another publishing option is easier
If your site runs on WordPress and you prefer to publish through its admin screen, use the free SO4AG Facts plugin. If you prefer SOQVER to host the page, file, and JSON-LD, use the guided start to review, complete, and confirm the facts for a hosted profile.
Next step
Run the free website audit, then use the result to review the facts you want to publish on your domain.