Skip to content

Manage your site’s meta tags for display in search engine results or social media networks. Create and manage json-ld microdata. Includes an easy-to-use live preview feature.


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

Grav SEO Plugin


Table of Contents:


Seo is an user-friendly plugin for used to manage all your metatags in order to customize your pages appearance in Search Engine Results or social networks. The plugin also allows the generation of JSON-LD Microdata.



You can see and customize how your page will look on Google Search Results.

Grav SEO Plugin


You can also preview how your page will look when shared on twitter

Grav SEO Plugin


And on Facebook

Facebook Live Preview


You can also generate JSON Microdata from the admin. Article Microdata This will generate the following Json-ld between script tags

    "@context": "",
    "@type": "Article",
    "headline": "Article Title",
    "mainEntityOfPage": {
        "@type": "WebPage",
        "url": ""
    "articleBody": "Lorem Ipsum dolor sit amet",
    "datePublished": "2017-12-01T00:00:00+00:00",
    "dateModified": "2019-01-01T00:00:00+00:00",
    "description": "Description of the article",
    "author": "Steve Jobs",
    "publisher": {
        "@type": "Organization",
        "name": "Apple",
        "logo": {
            "@type": "ImageObject",
            "url": "",
            "width": "200",
            "height": "100"
    "image": {
        "@type": "ImageObject",
        "url": "",
        "width": "800",
        "height": "600"


In order to use the plugin with a custom template, there is two requirements, you must:

  • Include in your base template the metadata template that comes shipped with antimatter, such as: {% include 'partials/metadata.html.twig' %}
  • For Microdatas, you must use Grav's asset manager. If your template has a line with {{ assets.js() }}, it will works.
  • The SEO tab extends the default blueprint, if it does not appear, make sure your blueprint extends the default blueprint with extends@: default

Feedback needed

As this plugin is in its early stage, please do not hesitate to leave a feedback, to suggest modification or features.


  • Add more Microdata type
  • Add Translations (Contribution welcomed!)
  • Add the possibility to add multiple microdata of the same type
  • YoastSEO text analysis integration (WIP)
  • Add some microdata on every page

Installation and Updates

Updating from Previous releases

As there is a lot of changes from previous releases, be careful when updating, as your previously set values might be lost. The previous version required to modify your base template, whereas the 2.0+ version of the plugin now adds metadata and microdata automatically to your existing Installation.

Installing or updating the SEO plugin can be done in one of three ways. Using the GPM (Grav Package Manager) installation update method (i.e. bin/gpm install seo) or manual install by downloading this plugin and extracting all plugin files to


Once installed, the plugin will automatically set the metadata and append the json-ld microdatas to your document. If you plan on using the Twitter feature, make sure to fill your user ID in tab Plugins > SEO > Twitter ID


Configuration is done through the plugin configuration page, accessible by clicking on Plugins > Seo. On this page, you can choose to enable the microdata fields you will use. Make sure to fill the Facebook ID field as well as the Twitter ID field, in order for your meta tags to be validated.


The SEO plugin appends a SEO tab on every pages where you can manage and define how your website will look on search engine results and on social networks.


You can contribute at any time! Before opening any issue, please search for existing issues!

After that please note:

  • If you find a bug, would like to make a feature request or suggest an improvement, [please open a new issue][issues]. If you have any interesting ideas for additions to the syntax please do suggest them as well!
  • Feature requests are more likely to get attention if you include a clearly described use case.



Manage your site’s meta tags for display in search engine results or social media networks. Create and manage json-ld microdata. Includes an easy-to-use live preview feature.








No packages published