How to add Structured Data to Joomla Articles

Component Joomla! Content
Supported Views Article
Supported Content Types Article
Availability Since v1.0.0

Google Structured Data integrates perfectly with Joomla's default Content Manager for all the item based snippets available. This means that you can select any Content Item belonging to Joomla's default Content Manager and generate any of the available Content Type Snippets for it. Let's see how you can take advantage of this integration.

Enable Integration

As with all of the integrations, you need to navigate to Components > Google Structured Data > Configuration and click the Integrations Tab where all the Integrations are listed.

gsd3-integrations

Find the "Joomla Content" Integration in the list and make sure that it is enabled with the green checkmark indicator as shown in the screenshot below.

Joomla! Content Structured Data

Integration Settings

To view the available settings, go to Google Structured Data -> Configuration and click on the gear button next to the integration's name.

In the Joomla! Content integration settings screen, you will find the following 3 options:

Enable Fast Edit

If enabled, a tab called Google Structured Data will be activated in the article's editing page in order to be able to directly edit your Content Types.

Use Custom Fields

Enable this option if you'd like to map schema properties with the custom fields assigned to Joomla! Articles

Prepare Content

If enabled, the article's content will be prepared with the Joomla! Content Plugins. This is rather useful, when you use plugin shortcodes in your article. Otherwise, it's recommend to be disabled for performance reasons.

Add Article Structured Data to Joomla! Articles

Let's see how you can add the Article Content Type to Joomla! Content pages. From the Components menu, choose Google Structured Data, nagivate to the Items section and click on the New button to create a new Structured Data Item.

On the next page, you will see the following 3 options where you will need to select the Article Content Type and the Joomla! Content Integration respectively as shown in the screenshot below.

Click Save to return to the same page. Once the item is saved 2 new sections appearing.

  • Article: This section helps you map the content type properties with Page options, Meta Properties, Site info and more.
  • Publishing Rules: This is where you can select the pages where the structured data is going to be generated to.

To learn more details on how you can use these sections visit the How to Add Structured Data to Pages documentation page.

Publishing Rules

In case, you don't want to generate the Article Content Type to all pages, you can use the available publishing rules to target specific pages. The Joomla! Content Integration implements the following publishing rules:

NameDescription
Article Target specific Joomla! Content Articles only.
Category Target all Articles assigned to specific Joomla! Categories.

To learn more about the Publishing Rules section visit the How to add Structured Data to Pages documentation page.

Remember, in case you don't enable any publishing rules, the structured data will be generated on all Joomla! Content articles.

Notes

The Structured Data is generated only in the Article View of the Joomla! Content component where a single Article is displayed. The Category, Blog and List views are not currently supported.

How to remove Joomla! default Microdata

Joomla! includes by default the Article Structured Data in all article pages using the microdata format (Google recommends JSON-LD format). According to the Google Structured Data Testing Tool, that Article schema has numerous errors and warnings as it's missing out most of the Article Schema properties required by Google in order to be eligible for the search results.

To prevent structured data errors and conflicts, it's recommend to remove the Joomla! default Article Schema. To do so, visit the How to Remove Faulty Microdata guide.