HomeSelf VPR Connector

Bring your properties into AI conversations.

HomeSelf VPR Connector connects your WordPress property pages to canonical HomeSelf Verified Property Records (VPRs). A VPR is an AI-readable property record.

Who this is for:

• Hotels and direct booking sites — Make your property easier for AI assistants to understand
• Property managers — Connect your portfolio to canonical VPRs for AI-mediated discovery
• Real estate agencies — Turn listings into structured records AI can compare
• Short-term rentals — Villas, apartments, B&Bs, and aparthotels

What this plugin does:

• Displays a clean, professional property record card
• Shows a trust badge linking to the canonical HomeSelf VPR
• The card can optionally show a Copy AI prompt button
• Includes copyable AI setup help prompts
• Adds structured data references for AI and search systems
• Works with Gutenberg blocks
• Works with Elementor widgets (when Elementor is active)
• Works with any WordPress theme via shortcodes
• Fetches data from HomeSelf with smart caching

What this plugin does NOT do:

• Does NOT create or manage VPRs on HomeSelf
• Does NOT guarantee AI search visibility, ranking, or citation
• Does NOT claim SEO benefits or booking guarantees
• Does NOT verify property ownership
• Does NOT require API keys or account connection
• Does NOT replace your booking engine or PMS

Quick setup in 5 steps:

1. Create a VPR on HomeSelf
2. Install the WordPress plugin
3. Paste your VPR URL or Property ID
4. Add the block, widget, or shortcode to your page
5. Publish

Integration options:

• Gutenberg Block — Add the HomeSelf VPR Card block in the WordPress editor
• Elementor Widget — Use the HomeSelf VPR Connector widget (requires Elementor)
• Shortcode — Paste a shortcode into any page, post, or builder

Display formats:

• Card — Best for full property pages, showing complete information with optional AI prompt copy button
• Badge — Best for compact trust indicators and sidebar placement

Shortcode usage:

[homeself_vpr id="uuid-or-slug" template="card|badge" theme="standard|dark" ai_record_tools="1|0" markdown_link="1|0"]

• id — Property ID or slug from HomeSelf (optional if default is set)
• template — card (full card) or badge (trust badge)
• theme — standard (light theme) or dark (dark theme), default uses plugin setting
• ai_record_tools — Show AI-readable record tools in card (default: from settings)
• markdown_link — Show Markdown download link (default: from settings)

AI Discovery Metrics

The plugin introduces these concepts to help you understand AI-mediated property discovery:

• AI Exposure — Your property was retrieved, considered, or evaluated by an AI system
• ASR — AI Selection Rate — How often your property is selected by AI after being evaluated for a user intent
• HSR — Human Selection Rate — How often people take action after arriving from an AI recommendation
• Trust Score — A signal of data reliability, completeness, and evidence quality

Note: ASR and HSR reporting require HomeSelf analytics and may not be available in this connector MVP.

AI-readable property data layer

The plugin can add structured machine-readable references to the canonical HomeSelf VPR endpoints:

• JSON-LD endpoint — Structured data format for AI systems and search engines
• AnswerPack endpoint — Optimized for answer engines and AI assistants
• Markdown endpoint — Human-readable documentation format

The VPR card can optionally show a compact AI-readable record drawer with:
– JSON-LD link
– AnswerPack link
– Markdown download link
– Copy VPR link button

These references do not guarantee AI visibility, ranking, or citation. They provide structured links that make the canonical VPR easier to locate and interpret.

The WordPress page remains your human-facing page. HomeSelf remains the canonical machine-readable VPR source.

Is this for hotels or independent properties?

Both. Hotels with direct booking websites, independent property managers, real estate agencies, and short-term rental hosts can all use this plugin. Choose your use case in settings for tailored guidance.

What is the difference between this and a booking engine?

This is NOT a booking engine. Your WordPress site remains your human-facing property page. HomeSelf provides a canonical AI-readable property record. The connector simply links the two.

Will this slow down my website?

No. The plugin uses server-side fetching with WordPress transients for caching. Data is only fetched when needed and cached according to your settings.

Does this work with Gutenberg?

Yes. The plugin includes a native Gutenberg block called “HomeSelf VPR Card” that you can add to any page or post using the block editor.

Does this work with Elementor?

Yes. When Elementor is installed and active, the plugin provides a “HomeSelf VPR Connector” widget that you can drag and drop onto any Elementor page.

Is this compatible with page builders?

Yes. The shortcode works with any page builder that supports WordPress shortcodes, including Divi, Beaver Builder, and others.

Does this work with caching plugins?

Yes. The plugin uses WordPress transients for its own caching and is compatible with page caching plugins like WP Rocket, W3 Total Cache, and others.

Can I use this on multiple properties?

Yes. Install the plugin once. Add a different VPR ID to each property page using the block, Elementor widget, or shortcode. You can reuse the integration methods across multiple pages with different VPR IDs.

What happens if my VPR changes on HomeSelf?

The plugin fetches fresh data based on your cache settings. You can also manually refresh from the settings page.

Does this collect any data?

No. The plugin only fetches public VPR data from HomeSelf. No personal information is collected or stored.

Does the plugin expose machine-readable property data?

Yes. The plugin adds structured references and alternate links to the canonical HomeSelf VPR JSON-LD, AnswerPack, and Markdown endpoints. The VPR card can optionally show a compact AI-readable record drawer with actions for JSON-LD, AnswerPack, Markdown, and Copy VPR link. The WordPress page remains your human-facing page; HomeSelf remains the canonical machine-readable VPR source.

Privacy Policy

HomeSelf VPR Connector respects your privacy:

• The plugin only fetches public data from homeself.ai
• No personal information is collected or stored
• No tracking or analytics are included
• All data processing happens on your WordPress server

External Service Disclosure

This plugin connects to the HomeSelf public service to retrieve public Verified Property Record (VPR) metadata configured by the site administrator.

Service name: HomeSelf
Service URL: https://homeself.ai
Terms of Service: https://homeself.ai/terms
Privacy Policy: https://homeself.ai/privacy

What the service is used for:
The service is used to fetch public VPR metadata so the plugin can display a VPR card, compact badge, and AI-readable structured references on WordPress property pages.

What data is sent:
When a site administrator configures a VPR URL, property ID, or slug, the plugin may send that configured public identifier to HomeSelf public endpoints in order to retrieve the matching public VPR metadata.

When data is sent:
Data is sent when the administrator tests the connection, refreshes cached VPR data, previews the VPR card in the plugin settings, or when the WordPress page renders and cached VPR data needs to be fetched or refreshed.

What data is received:
The plugin receives public VPR metadata such as property title, location, canonical VPR URL, JSON-LD URL, AnswerPack URL, Markdown URL, and related public display fields.

What is not sent:
The plugin does not send private WordPress user data, passwords, billing data, owner verification documents, private property documents, or visitor personal data to HomeSelf.

AI providers:
The plugin does not send data to OpenAI, Anthropic, Google, Perplexity, or other AI providers. AI prompt/copy features only copy text to the visitor clipboard.

No affiliation / no guarantee:
HomeSelf is not affiliated with OpenAI, Anthropic, Google, Perplexity, Elementor, or WordPress. The plugin does not guarantee AI inclusion, ranking, citation, visibility, selection, or bookings.

Third-Party AI Assistant Disclaimer

The plugin references AI assistants such as ChatGPT, Claude, Gemini, Perplexity, and Google AI Mode for explanatory purposes only. HomeSelf is not affiliated with OpenAI, Anthropic, Google, or Perplexity. The connector does not guarantee inclusion, ranking, citation, or visibility in any AI system or search engine.