Listdom AI Visibility Documentation

本頁內容尚未翻譯。

Listdom AI Visibility provides a configurable public directory feed and optional discovery hints for machine-readable directory discovery.

Go to Listdom > Settings > General to configure the AI Visibility options.

Public AI Feed

Enable Public AI Feed to expose published directory data through public Listdom REST endpoints. The feed is designed for machine-readable discovery without requiring access to WordPress administration.

The public feed is disabled by default. It is also unavailable when WordPress discourages search engines from indexing the site. Check Settings > Reading > Search engine visibility if the feed is enabled in Listdom but its endpoints remain unavailable.

The feed includes only published, guest-accessible, non-password-protected listings. Draft, pending, private, trashed, password-protected, and otherwise restricted listings are excluded.

Public feed fields

Use Public Feed Fields to control which optional listing fields can appear in the feed:

Description
Excerpt
Address
Coordinates
Contact Details
Categories
Locations
Price
Images
Opening Hours
FAQs

Contact Details are disabled by default. Review this option carefully before enabling it. Only enable fields that the directory intentionally publishes for reuse.

Active add-ons can contribute additional public information:

Include Booking Summary adds a public summary of booking availability and setup when the Booking add-on Booking is active.
Include Verified Status adds the public verification state when the applicable add-on is active.
Include Reviews/Ratings adds public review and rating information when the Reviews add-on Reviews is active.

Disabling a field removes it from feed responses even if the listing contains that information.

Public endpoints

When the feed is enabled and the site is publicly indexable, Listdom provides these endpoints:

/wp-json/listdom/v1/public/listings
/wp-json/listdom/v1/public/listings/{id}
/wp-json/listdom/v1/public/categories
/wp-json/listdom/v1/public/locations

Replace {id} with a listing ID.

The listings endpoint supports pagination and directory filtering. Common request parameters include page, items per page, search text, included or excluded listing IDs, authors, and taxonomy filters. The maximum number of listings returned per request is 100.

Category and location endpoints support pagination, search, and empty-term filtering. The maximum items-per-request limit also protects the site from unbounded responses.

A listing response always identifies the public resource with core information such as its ID, type, title, URL, and publication or update dates. Other fields depend on Public Feed Fields, listing data, active add-ons, and public visibility rules.

If the feed is disabled or the site is not publicly indexable, the public endpoints return an unavailable response rather than directory data.

AI discovery options

Listdom can help compatible crawlers find the public feed in three ways.

Add llms.txt Discovery

Enable this option to provide a dynamic /llms.txt discovery file that describes the directory feed. Listdom only supplies the dynamic file when the public feed is available and no existing route or content already owns that location.

If the site already uses a physical or plugin-generated llms.txt, keep one authoritative version and add the Listdom feed links there if needed.

Add robots.txt Discovery Hints

Enable this option to add Listdom discovery hints to WordPress’s virtual robots.txt output. This does not edit a physical robots.txt file on the server.

If the site uses a physical robots.txt, review that file separately because it can take precedence over WordPress’s virtual output.

Add HTML Feed Discovery Links

Enable this option to add machine-readable discovery links to applicable public Listdom pages. These can include single listings, listing archives, supported taxonomy archives, search results, and listing-shortcode contexts.

Recommended privacy review

Review a representative set of public listings.
Decide whether contact details and exact coordinates should be reusable.
Enable only the fields needed by the directory.
Open the collection and single-listing endpoints in a logged-out browser.
Confirm that draft, private, password-protected, and restricted listings are absent.
Review information contributed by Booking, Reviews, Claim, membership, and verification add-ons.
Repeat the review after changing public listing fields or add-on settings.

Listdom’s public feed is not an export of the WordPress database. It is a controlled public representation of eligible listing data.

Troubleshooting

The feed returns an unavailable or forbidden response

Confirm that Public AI Feed is enabled and that WordPress search engine visibility allows indexing. Also clear page, object, and CDN caches after changing the setting.

A listing is missing

Confirm that the listing is published, not password-protected, and accessible to a logged-out visitor. Membership or access-control rules can exclude a listing even when its WordPress status is Published.

`/llms.txt` does not show the Listdom feed

Confirm that the feed and Add llms.txt Discovery are enabled. Then check whether another plugin, a physical file, or a custom route already provides /llms.txt.

`robots.txt` does not contain the hints

Listdom changes WordPress’s virtual robots.txt. A physical file at the site root can override it. Check the file served at the public /robots.txt URL rather than only the WordPress setting.

A field is missing from the response

Check all of the following:

The field is enabled under Public Feed Fields.
The listing has a public value for the field.
The listing is published and not password protected.
The required add-on is active for add-on fields.
A cache is not serving an older response.

Contact details appear unexpectedly

Disable Contact Details under Public Feed Fields, save the settings, and test the endpoint again while logged out.

FAQ

Is the Public AI Feed enabled automatically after an update?

No. It is an opt-in feature and remains unavailable when the site discourages search-engine indexing.

Does enabling discovery guarantee AI citations?

No. It makes public data easier to discover. External services decide whether and how to crawl or use it.

Does the feed expose booking records or payments?

No. The optional Booking contribution is a public summary. It does not expose customer bookings, private availability records, orders, or payment details.

Can I disable coordinates but keep the address?

Yes. Address and Coordinates are separate public feed field options.