Problem Summary
Your real estate website built with Oxygen Builder isn’t showing ACF custom fields properly in search results, or Google isn’t picking up your property listings correctly. This directly impacts your ability to attract potential buyers and sellers through organic search, potentially costing you valuable leads.
Step-by-Step Fixes
Step 1: Verify ACF Fields Are Actually Outputting
First, let’s make sure your Advanced Custom Fields are even showing up on the page. Open your property listing in Oxygen Builder’s editor and switch to preview mode. Right-click and select “View Page Source” to check if your custom field data appears in the HTML.
If you don’t see your fields in the source code, your Oxygen dynamic data isn’t configured properly. Go to the element where you want the field to display, click the data icon, and select “ACF” from the dropdown. Choose your specific field group and field name.
Step 2: Add Schema Markup for Real Estate
Google needs structured data to understand your property listings. Without proper schema markup, your beautiful custom fields mean nothing to search engines. Here’s the code to add to your Oxygen template:
“`php
{
“@context”: “https://schema.org”,
“@type”: “RealEstateListing”,
“name”: “”,
“description”: “”,
“offers”: {
“@type”: “Offer”,
“price”: “”,
“priceCurrency”: “USD”
},
“address”: {
“@type”: “PostalAddress”,
“streetAddress”: “”,
“addressLocality”: “”,
“addressRegion”: “”,
“postalCode”: “”
},
“numberOfRooms”: “”,
“numberOfBathroomsTotal”: “”
}
“`
Add this code using Oxygen’s Code Block element in your single property template. Place it in the page header or footer for best results.
Step 3: Configure Yoast SEO or Rank Math for ACF Integration
Your SEO plugin needs to know about your custom fields. If using Yoast SEO, install the ACF Content Analysis for Yoast SEO plugin. For Rank Math users, the integration is built-in but needs activation.
Navigate to your SEO plugin settings and look for the Schema or Structured Data section. Enable property schema and map your ACF fields to the appropriate schema properties. This ensures your meta descriptions and titles can pull from your custom fields dynamically.
Step 4: Create Dynamic Meta Tags
Static meta descriptions won’t cut it for hundreds of property listings. Add this to your functions.php file to generate dynamic meta descriptions from your ACF fields:
“`php
add_filter(‘wpseo_metadesc’, ‘dynamic_property_meta_description’);
function dynamic_property_meta_description($desc) {
if (is_singular(‘property’)) {
$bedrooms = get_field(‘bedrooms’);
$bathrooms = get_field(‘bathrooms’);
$price = get_field(‘property_price’);
$city = get_field(‘city’);
$desc = sprintf(‘%s bed, %s bath home for $%s in %s. %s’,
$bedrooms,
$bathrooms,
number_format($price),
$city,
wp_trim_words(get_field(‘property_description’), 20)
);
}
return $desc;
}
“`
Step 5: Fix Oxygen’s Caching Issues
Oxygen Builder’s caching can prevent search engines from seeing updated ACF field values. Clear all caches after making changes: Oxygen cache, WordPress cache, and any CDN cache you’re using.
Go to Oxygen > Settings > Cache and click “Regenerate CSS Cache.” Then clear your hosting cache and purge any Cloudflare or other CDN caches. This step is ideal for ensuring Google sees your latest property data.
Step 6: Test with Google’s Rich Results Tool
Visit Google’s Rich Results Test tool and enter your property listing URL. This shows exactly what structured data Google can read from your page. If errors appear, the tool tells you which required fields are missing or formatted incorrectly.
Likely Causes
Cause #1: ACF Fields Not Set to Public
Your ACF field groups might be configured incorrectly. Check if your fields are set to display publicly by going to Custom Fields > Field Groups in your WordPress admin. Edit your property field group and ensure “Show in REST API” is enabled under the Settings tab. This setting is best used in scenarios where you need search engines to access your data.
To verify, try accessing your property data through WordPress REST API by visiting: `yoursite.com/wp-json/wp/v2/properties/[post-id]`. If your custom fields don’t appear, they’re not publicly accessible.
Cause #2: Oxygen Dynamic Data Syntax Errors
Oxygen uses specific syntax for displaying ACF fields, and small typos break everything. The correct format for repeater fields, relationship fields, and basic fields differs significantly.
For basic fields, use: `[oxygen data=’acf’ field=’field_name’]`
For repeater fields, you need Oxygen’s Repeater element with proper query parameters
For relationship fields, additional loops are required
Double-check your dynamic data connections in Oxygen’s structure panel. Look for red error indicators that signal broken field connections.
Cause #3: Missing SEO Plugin Integration
WordPress doesn’t automatically know your custom fields should appear in search results. Without proper SEO plugin configuration, Google only sees your main content area, ignoring valuable property details stored in ACF.
Check if your SEO plugin recognizes your custom post type. In Yoast, go to SEO > Search Appearance > Content Types and ensure your property post type is set to show in search results. Enable schema markup specifically for real estate listings.
When to Call Expert Help
Contact a WordPress developer experienced with Oxygen Builder when you see database errors, white screens, or if property data disappears after updates. These symptoms indicate deeper structural issues beyond simple configuration problems.
Professional help is not recommended when you’re just starting out and learning the basics. However, it becomes essential if your real estate website generates significant revenue and downtime costs you money. A specialist can implement advanced solutions like custom REST API endpoints or headless WordPress setups for better SEO performance.
Look for developers who specifically mention ACF and Oxygen Builder experience. Generic WordPress developers might not understand Oxygen’s unique structure, potentially making problems worse.
Copy-Paste Prompt for AI Help
“`
I have a WordPress real estate website using Oxygen Builder with ACF custom fields. My property listings aren’t showing up properly in Google search results.
Details:
- WordPress version: [your version]
- Oxygen Builder version: [your version]
- ACF version: [your version]
- SEO Plugin: [Yoast/Rank Math/Other]
- Property fields include: bedrooms, bathrooms, price, address, description
- Error messages: [paste any errors]
- What I’ve tried: [list your attempts]
Please help me troubleshoot why my ACF property data isn’t appearing in search results and provide specific code solutions for Oxygen Builder.
“`
Remember, fixing SEO issues with custom fields requires patience. Google needs time to recrawl and reindex your pages after making these changes. Monitor your Search Console for improvements over the next few weeks, and don’t panic if results don’t appear immediately. Your real estate listings will start ranking better once search engines properly understand your structured property data.