Add your own extra details to properties (pool type, property manager, anything you like) using a simple Google Sheet, even when your PMS has no place to store them.
What it does #
Sometimes you need data on a property that your PMS just does not have a field for, or your PMS (Hospitable, for example) does not support custom fields at all. External Custom Fields lets you keep that data in a Google Sheet and have your website read it in automatically.
You pick the field names (for example pool_type, property_manager, view), fill in the values per property, and the module syncs them to your site on a schedule. Once synced, the values behave just like any other property field: they show up as dynamic content in YOOtheme Pro, Elementor, and any other page builder that reads property fields, and they can feed certain HomeRunner settings such as meta title, meta description, and the Explorer subtitle.
No PMS support and no Central changes are required. The data lives in your sheet and flows to your site.
How to set up the data source #
1. Enable the module #
In the HomeRunner Toolkit Hub, switch on External Custom Fields.
2. Generate the starter sheet #
Click Generate Sample CSV. This produces a spreadsheet already filled with every property on your site, each identified by its unique ID, plus sample columns.
3. Build your sheet #
Paste that data into a Google Sheet. Rename the sample columns to your real field names (for example pool_type, property_manager) and fill in the values for each property. Empty cells are simply skipped.
4. Publish the sheet as CSV #
In Google Sheets, go to File → Share → Publish to web and publish as CSV. Copy the published URL.
5. Connect it #
Paste the published CSV URL into the module settings, choose a sync interval, and click Sync Now. Your values are now live on the site.
Sync settings #
| Setting | What it controls |
|---|---|
| CSV URL | The published Google Sheet (CSV) the module reads from. |
| Sync interval | How often the sheet is pulled automatically: hourly, twice daily, or daily. |
| Sync Now | Pulls the sheet immediately, without waiting for the schedule. |
| Remap Properties | Refreshes the property list in your sheet when new properties arrive from Central, without losing the values you already entered. |
The sheet re-syncs on your chosen schedule. Removing a property’s row (or clearing its cells) clears that property’s custom field data on the next sync.
Using the values #
Once synced, the fields appear automatically in your page builder’s dynamic-content picker, the same way PMS-synced fields do. There is also a shortcode for placing a value directly in content:
[hrtk_custom_field name="pool_type" default="N/A"]
Tips #
- After adding a batch of new properties via Central, click Remap Properties so they appear in your sheet, then fill in their values. Your existing entries are preserved.
- Keep field names short, lowercase, and consistent (for example
pet_policy, notPet Policy!). They become the keys your page builder reads. - These values can also feed source-mapping dropdowns (meta title, meta description, subtitle, and similar), which is handy for SEO text you want to manage in a spreadsheet rather than per page.
- If you are looking to attach visual badges rather than text fields, see Label Designer. For the broader picture of supporting modules, see Under the Hood (Automatic Optimizations).