Don’t forget to subscribe to our YouTube channel to stay up-to-date.
When someone shares a Facebook post with a link to your website, Facebook lets you control how your website content appears to others by parsing your Open Graph (OG) markup.
By doing some minimal configuration changes on your Drupal site using the Metatag Module and the Metatag: Open Graph sub module, you can define what specific content can be shown on Facebook regardless of whether it’s shared from the desktop or mobile web or a mobile app.
It is easier to explain by showing the end result of what we are trying to accomplish. For example, the homepage of www.webwash.net has the following OG markup inside of the
If someone posted www.webwash.net to Facebook, then Facebook would parse the OG markup like this:
And the end result would look like this:
You can clearly see the corresponding OG tags for the content.
If you want to learn more about the OG tags. Click here for a detailed list and explanations of the Facebook OG tags.
In this tutorial, we are going to show you how to configure a content type to dynamically populate the Facebook OG tags using the Metagtag module and Metatag Open Graph sub module.
The Metatag module has a dependency on the Token module. However, if you download and enable the Drupal module using composer and drush, the dependency is automatically taken care of as we will show you now.
Use Composer to download the module:
composer require drupal/metatag
Once the Metatag module is downloaded using composer, the Token module, which is a dependency, will be downloaded automatically.
Then enable the “Metatag: Open Graph” sub module:
drush en metatag_open_graph -y
The above drush command will automatically enable the Metatag: Open Graph sub module, Metatag module and Token module.
Finally, it is always a good idea to clear the cache after enabling Drupal modules:
Configure Open Graph Tags
By default, Open Graph can be added to any content type. We will now configure Open Graph for the Article Content type.
1. Go to Configuration > Search and meta data > Metatag and click on “Add default meta tags”.
2. On the next page, select “Article” (or whatever content type you want to configure) from the Type dropdown.
3. Then click on Save. This is required for the correct tokens to appear in the “Browse available tokens” window.
4. Edit the “Content: Article” configuration from the Metatag page.
5. Then in the Open Graph fieldset on the same page, click to expand it. You will now notice quite an exhaustive list of OG tags that you can populate. Firstly, we are going to demonstrate how to populate the Image OG tag.
For this to be successful, your Article content must have at least an image field. We will show you how to use Token to grab that image data.
Click on “Browse available tokens”.
From the Token window click on Nodes to drill down and find the content type fields.
NOTE: If you can’t see “Nodes”, this means you need to save the “default meta tag” option first then edit it again.
Fill in the following fields:
- Content type:
- Page URL:
- Image URL:
[node:field_image](adjust the field name accordingly)
Find Image Field Token
To use an image stored in an image field, click on “Browse available tokens”.
Then drill down by going to Nodes -> Image. This assumes you’re using the Image (
field_image) field on the Article content type.
The token should be
Find Image Field Token on Media Asset
If you’re using a media field instead of an image field for handling assets, then use the following token,
[node:field_media:entity:thumbnail] (change the field_media name accordingly).
6.After you fill out all of your OG tags fields, click on Save and clear the Drupal cache. If you do not clear your cache, the OG fields may not populate for existing content.
7. Once you have filled out the other OG fields with their respective token values, you should validate the resulting OG markup using the Facebook Sharing Debugger tool. We will now show you how to validate your OG markup.
NOTE: Your website has to be publicly accessible for the debug tool to work.
8. First we need to create a test Article node (make sure to upload an image to our image field). Our test article looks like this:
9. Paste the url for this node into the Facebook Sharing Debugger tool. The output should look like:
As you can see, Facebook successfully parsed our OG markup and displayed the information correctly.
Facebook lets you control your website’s content whenever someone’s shares a link to your content regardless of whether it’s shared from the desktop or mobile web or a mobile app. Facebook does this by parsing the Open Graph (OG) markup provided by your website. We have shown how you can use the Metatag module and Metatag Open Graph sub module to configure Drupal 8 to correctly generate the OG markup needed by Facebook and we have also shown how to validate your OG markup to ensure Facebook correctly parses your website content.
Q: I changed the default meta tag configuration, but the tags are not changing?
Try clearing the site cache. Go to Configuration > Performance and click on “Clear all caches”.