A free plugin that publishes the facts of your business on your own site so that AI assistants and other programs can use them correctly: what applies, for whom, and until when. Prices, hours, payment, shipping, cancellation, warranty.
Download the plugin (ZIP, version 0.1.0) Read the manual
Free, no account, no paid features. Works with WooCommerce. WordPress 6.4 or newer, PHP 7.4 or newer. License GPL-2.0-or-later.
https://your-site.com/so4ag.json
Every fact in the open SO4AG format. Anyone can read it, with no key and no sign-up.
A "Facts and terms" table on any page: the fact, its value, who it applies to and until when.
Added with a block or the shortcode [so4ag_facts].
The same facts as JSON-LD (schema.org) in the code of that page, for search engines and tools that already read JSON-LD.
In the WordPress admin. With WooCommerce you start with one button: the plugin suggests shipping prices and payment methods from your store settings.
Nothing goes public by itself. Publishing needs your explicit confirmation that the facts are true.
The file, the page and the JSON-LD always carry the same, last confirmed version. Unfinished edits stay private.
Every fact has a last day on which it applies. Two weeks before, the admin reminds you to review it and confirm it again.
The names of tabs and buttons below are written as you see them in the plugin.
Contents: 1. Install · 2. Your business · 3. Add facts · 4. Conditions · 5. WooCommerce · 6. Publish · 7. The page · 8. Check · 9. Keep it current · 10. llms.txt · 11. Troubleshooting
On the Business tab check the name of your business, pick the kind of business and add registration identifiers if you want (a scheme and a value, for example ein and your EIN, or vat and a VAT number). The contact for corrections is optional and public.
On the Facts tab pick a kind of fact and select Add. Every fact asks for four things:
| Fact | Where to find it | Required condition | Longest |
|---|---|---|---|
| Operator | footer, terms | – | 400 days |
| Location | contact page: address and hours | – | 180 days |
| Contact | contact page | channel | 180 days |
| Price | price list | item | 60 days |
| Payment methods | terms, checkout | – | 180 days |
| Booking required, Response time | booking page, contact page | – | 90 days |
| Free cancellation, Cancellation fee | cancellation policy | – | 90 days |
| Guarantee | warranty policy | – | 180 days |
| Accepts new customers | contact page | – | 30 days |
| Shipping price | shipping page | country, delivery_method | 60 days |
| Free shipping from, Cash on delivery fee | shipping page | country / – | 60 days |
| Return period, Warranty period | return policy, terms | – | 180 days |
The plugin offers 25 facts for any business and 10 for an online store. "Longest" is the longest time a fact can be confirmed for at once; the plugin does not accept a later date.
customer: business applies to businesses only; a program asking for a private person will not use it.any says outright "this holds for every value".item) the same way every time. "Teeth cleaning" and "cleaning" are two different things to a program.Mo-Fr 09:00-18:00; Sa 09:00-12:00The Suggest from the shop button reads your store settings and prepares suggestions:
You Accept, Complete or Dismiss each suggestion. Suggestions are not public. What the plugin cannot read from the settings (a price given by a formula, free shipping by coupon only, carriers from other plugins) it tells you in a note.
The Confirm and publish tab shows what will be public and what changed since last time. Check the box that confirms the facts are true today and select Confirm and publish. From then on, anything you edit stays private until you confirm again.
To take the facts down, use Withdraw on the same tab. Your working facts are kept.
On the Output and check tab select Create a draft page "Facts and terms", look the page over, publish it and link it from your footer. To place the facts on a page of your own, add the Facts and terms block or the shortcode:
[so4ag_facts]
[so4ag_facts heading="no"]
[so4ag_facts level="h3"]
The plugin adds no link or badge to your site and does not change the output of other plugins. The JSON-LD appears only on pages where you place the facts.
https://your-site.com/so4ag.jsonA fact past its last day stays in the file, but programs treat it as history and the table marks it. The admin warns you 14 days ahead. A sensible rhythm:
The plugin can answer at /llms.txt with a short file that points to your facts. It is off by default; you turn it on at the Output and check tab. If your site already has an llms.txt, the plugin leaves it alone and shows the lines you can add to it yourself.
| What you see | What to do |
|---|---|
/so4ag.json returns "not found" | The web server did not pass that address to WordPress. Turn on pretty permalinks (Settings → Permalinks) or ask your host to send requests for missing files to WordPress. Until then the address /?so4ag_facts=json works. |
| The check says the page carries other facts than the file | A cache holds an older copy of the page. Clear it and check again. |
| The page has no JSON-LD | The page has neither the block nor the shortcode, or the theme does not call wp_footer(). |
| The plugin refuses a date | Each kind of fact has a longest time it can be confirmed for. Pick an earlier date and confirm it again later. |
| The site runs on http | The file is served, but programs expect it over https. |
Do you build or maintain client sites? Setting up the facts is work you bill yourself, and because facts have a limited validity, somebody has to review them regularly. If a client also takes monitoring from the SOQVER service, the partner program pays you a share of that subscription. The account and the facts belong to the client.
Partner program The format and tools for developers
The source code of the plugin is in the package, licensed GPL-2.0-or-later. SO4AG is an open format and a working draft: the specification, the validator and the readers are free. Specification · GitHub
No. Entering the facts, publishing, the file, the page, the JSON-LD and the check all work in the plugin alone.
Yes. The plugin does not touch the output of other plugins. It adds its own JSON-LD block only to pages where you place the facts.
It stays in the file, but programs treat it as history and the table marks it as no longer valid. Review it, set a new date and confirm again.
Its settings, the working facts and the published version. Pages you created stay, without the table.