LW
LumenWP

Troubleshooting / FAQ

Schema / Rich Results Not Appearing?

  • Plugin Activation: Ensure both the “Local Business Schema Generator” (free) and the “Pro” version (if applicable) are activated.
  • Pro License: If using Pro features, ensure your license is active via the Freemius account page.
  • API Key & Place ID (for Reviews/Geo): If related to reviews or geo-coordinates, double-check that a valid Google Maps API Key is entered in Business Schema > Settings and a correct Google Place ID is entered for the specific Location post. Ensure the “Places API” and “Geocoding API” are enabled for your key in Google Cloud Console.
  • Location Posts Published: Schema is generated for ‘Published’ Location CPT posts. Drafts or private posts won’t output schema.
  • “Exclude Schema On” Setting: Check Business Schema > Settings > Schema Output Control to ensure the current post type isn’t excluded.
  • Caching: Clear all caches on your site (plugin cache, server cache, object cache) and your browser cache. Schema data might take time to reflect changes due to caching. Google Reviews data is also cached for 12 hours by default.
  • Google Indexing: It can take time for Google to recrawl your site and process new schema. Google also does not guarantee that rich results will be shown, even if your schema is valid.
  • Validate Your Schema: Use Google’s Rich Results Test to check for errors or warnings. The warning “Invalid URL in field ‘image'” is common if testing on a local (e.g., `.local`) development site, as Google cannot access local URLs; this can usually be ignored during local development.

Google Reviews Not Displaying via Shortcode?

  • Verify all points from “Schema / Rich Results Not Appearing?” above, especially API Key and Place ID validity for the specified location_id.
  • Ensure the location_id attribute in your shortcode (e.g., [lbsg_google_reviews location_id="123"]) is the correct numeric Post ID of a published ‘Location’.
  • The Google Places API (used by default) only returns a maximum of 5 “most relevant” reviews. If a business has fewer than 5, or if Google deems none relevant, no reviews might be shown.
  • Check your website’s debug.log file (if WP_DEBUG_LOG is enabled) for any specific error messages logged by the Google_Reviews_API_Handler.

“Fetch Geo Coordinates” Button Not Working?

  • Ensure a valid Google Maps API Key (with “Geocoding API” enabled) is saved in Business Schema > Settings.
  • Make sure you have entered enough address information (Street, City, Country) for the geocoding service to find a match.
  • Check your browser’s JavaScript console (usually F12) for any errors when you click the button.
  • Check your website’s debug.log file for any errors logged by the AJAX handler.

Subtype-Specific Fields (e.g., Menu URL for Restaurant) Not Showing in Editor?

  • Ensure you have selected the correct “Business Type” (e.g., “Restaurant”) from the dropdown. The specific fields only appear once the relevant type is chosen.
  • Make sure JavaScript is enabled in your browser, as these fields are shown/hidden using JavaScript.
  • If you suspect a JavaScript conflict, try temporarily deactivating other plugins or switching to a default WordPress theme to see if the issue resolves.

Support

If you’ve encountered an issue that isn’t covered in the Troubleshooting section or have other questions, here’s how you can get support:

Pro Version Support

For users of the Pro version, dedicated support is available through the Freemius platform. You can typically access support options through your account on the Freemius website or via the plugin’s section in your WordPress admin dashboard (often under Business Schema > Account or similar, depending on Freemius settings).

Free Version Support

For users of the free version, please use the official WordPress.org support forum for the plugin: Local Business Schema Generator Support Forum.

Information to Provide

When requesting support, please provide as much detail as possible to help us assist you quickly:

  • The version of the plugin you are using (Free and/or Pro).
  • Your WordPress version and PHP version.
  • A clear description of the issue.
  • Steps to reproduce the problem.
  • Any error messages you are seeing (copy them exactly).
  • Screenshots can often be very helpful.
  • If it’s a schema issue, provide the URL of the page in question and the output from Google’s Rich Results Test.