How to Implement JSON-LD
-
Hi,
I was implementing JSON-LD via Google Tag Manager but have since read that it is better to place directly on the web page.
My questions are:
-
Where exactly do you add the JSON-LD - I mean physically? This article by Moz says the head or body. Does it matter where in the head? At the end?
-
If you do not have development access- is there an easy way to insert?
-
Can you view the added JSON-LD directly on the web page after you have added it or is it not visible in the source once you have added it this way ? If you cannot see it, how do you view? Or it it just OK to use the Google Structured Testing tool as evidence that it is being seen by Google?
Thanks
-
-
Thank you.
-
For Wordpress, it depends if you have it set to filter out script tags from content. So, if you toggle content editing mode to html, and put in a script tag, whether it allows this or not. That is a setting in Wordpress. If it is filtering out your script tags, and if you don't want to (or can't) disable the script tag filtering, then using a plugin to administer the schema markup would be your best bet. There are generic plugins to insert script tags. And there are more specific plugins for schema markup, like Yoast (and others).
If you are inserting the scripts through GTM, then you may not see them when you simply "view source". With tag managers, you will see their container in the source code, but not the injected scripts. But if you instead use Chrome Developer Tools (right click and choose "inspect"), on the elements tab you will most likely find the injected scripts.
-
Thanks for the great response.
For question 2)
If your CMS is Wordpress and you don't have development access, how do you add the script? I'm assuming that the page is a static page. You basically just paste it into the page?
For question 3)
Could you explain why you can't see the asynchronous script in the source code. I'm not overly sure about this part and I'd like to understand it a bit better. When I used Google Tag Manager I couldn't see the script and I don't understand why not. Are you able to explain technically what happens with injecting it via GTM versus on the page itself?
Thank you
-
In answer to your questions:
1. You can place the JSON-LD in either location. If you are making use of data which may not be available at the beginning of the page load, then you might prefer to place at the very bottom of your body tag. But both locations work if you are simply inserting static content.
2. If you are using a CMS, you can simply insert the script as static content (as long as your CMS allows you to insert a script). This is assuming your page is a static page, not one which dynamically changes based on some server-side application. So, for example, if you have an article page on your site, and you want to insert schema to mark up that article, then this would be straightforward to do by simply inserting a script. But if your site is an e-commerce site and you are wanting to mark up all of your product details pages with product information, then this might be better done as part of the application. For static markup, if you search for "json ld generator" you will find some handy tools to simplify creating static scripts. Just be careful that you do not use static markup on a dynamic page where the page content might change based on application data, then causing inconsistency between your markup and the actual page content.
3. If you insert through your CMS, then yes you should see your script in the source code. If you use an ansynchronous script to inject your JSON-LD, then you might not see it in your source code, but could still see it by using dev tools inspect, after the page finishes loading. Either way, then use the Google Structured Data Testing Tool on the live URL to confirm that Google is able to parse the markup properly, with no errors. When you do that, look at its results to make sure the hierarchy of the data looks appropriate to you based on the data you know is on the page.
Got a burning SEO question?
Subscribe to Moz Pro to gain full access to Q&A, answer questions, and ask your own.
Browse Questions
Explore more categories
-
Moz Tools
Chat with the community about the Moz tools.
-
SEO Tactics
Discuss the SEO process with fellow marketers
-
Community
Discuss industry events, jobs, and news!
-
Digital Marketing
Chat about tactics outside of SEO
-
Research & Trends
Dive into research and trends in the search industry.
-
Support
Connect on product support and feature requests.
Related Questions
-
Breadcrumbs with JSON-LD
Just a quick question re implementation of JSON-ID breadcrumbs You are here: Acme Company → Electronics → Computers → Laptops So in this example laptops is my current page without a link on the visible on-page breadcrumb. When implementing JSON-LD BreadcrumbList should Laptops be included in the schema snippet, or commence from Computers to home?
Technical SEO | | MickEdwards0 -
What is SEO best practice to implement a site logo as an SVG?
What is SEO best practice to implement a site logo as an SVG?
Technical SEO | | twisme
Since it is possible to implement a description for SVGs it seems that it would be possible to use that for the site name. <desc>sitename</desc>
{{ STUFF }} There is also a title tag for SVGs. I’ve read in a thread from 2015 that sometimes it gets confused with the title tag in the header (at least by Moz crawler) which might cause trouble. What is state of the art here? Any experiences and/or case studies with using either method? <title>sitename</title>
{{ STUFF }} However, to me it seems either way that best practice in terms of search engines being able to crawl is to load the SVG and implement a proper alt tag: What is your opinion about this? Thanks in advance.1 -
Hreflang tag implementation
Hi Mozzers, For an international client, we want to install hreflang tags for 3 different languages for their website in Belgium: dutch, french and english. The dutch version (nl-be) and the french version (fr-be) can perfectly be installed, but our developer has troubles implementing the english version (en-be). According to ISO 639-1 , "en-be" is apparently not supported. Unfortunately, we can't generalize the hreflang tags (), because our client has different websites in each country, so we need to specifically target Belgium here. Does anyone have a solution? Thanks,
Technical SEO | | WeAreDigital_BE
Jens0 -
JSON-LD meta data: Do you have any rules/recommendations for using BlogPosting vs Article?
Dear Moz Community. I'm looking at moving from in-line Microdata in the HTML to JSON-LD on the web pages that I manage. Seems a far simpler solution having all the meta data in one place - especially for trouble shooting! With this in mind I've started to change the page templates on my personal site before I tackle the ones for my eCommerce site. I've made a start, and I'm still working on the templates producing some default values (like if a page doesn't have an associated image) but have been wondering if any of you have any rules/recommendations for using BlogPosting vs Article? I'd call this type of page an Article:
Technical SEO | | andystorey
https://cycling-jersey-collection.com/browse-collection/selle-italia-chinol-seb-bennotto-1982-team-jersey Whereas this page is from the /blog so that should probably be a BlogPosting:
https://cycling-jersey-collection.com/blog/2017-worldtour-team-jerseys I've used the following resources but it would be great to get a discussion on here.
https://yoast.com/structured-data-schema-ultimate-guide/
https://developers.google.com/search/docs/data-types/data-type-selector
https://search.google.com/structured-data/testing-tool/u/0/ I'm keen to get this 100% right as once this is done I'm going to drive through some further changes to get some progress on things like this: https://moz.com/blog/ranking-zero-seo-for-answers
https://moz.com/blog/what-we-learned-analyzing-featured-snippets Kind Regards andy moz-screenshot.jpg1 -
Product Schema implementation
Hi Once you have added structured data to a web page, say adding 'product schema' to a product page how long can you reasonably expect before it take effects, ie. displays rich snippets ? Also in the case of product schema what triggers the display of the rich snippet ? is it a branded keyword and product title search or just a product title search or can it result from a generic keyword search too ? All Best Dan
Technical SEO | | Dan-Lawrence0 -
Hreflang Implementation
Hello All, I'm currently working on a website with different folders for different country. For now I have defined the href lang implementation as below: http://www.homepage.com/en/default.html"/>
Technical SEO | | buiserik
Language: English - Country: United Kingdom http://www.homepage.com/enus/default.html"/>
Language: English - Country: United States http://www.homepage.com/nl/default.html"/>
Language: Dutch - Country: Netherlands http://www.homepage.com/nlbe/default.html"/>
Language: Dutch - Country: Belgium http://www.homepage.com/fr/default.html"/>
Language: French - Country: All french speaking countries http://www.homepage.com/de/default.html"/>
Language: German - Country: All german speaking countries http://www.homepage.com/es/camisa-a-medida.html"/>
Language: Spanish - Country: Spain http://www.homepage.com/enen/default.html" />
Language: English - Country: All other countries Does this make any sense? Furthermore, how do I implement this on underlying pages. Do I fill out the URL dynamically according to the URL the tags are found on? Or do I use these tags mentioning the homepage on all underlying pages? If so, how do I avoid duplicate content issues between NL and NL-BE and EN-GB, EN-US and EN? Canonicals? Besides the whole hreflang implementation I was wondering if it's worthwhile or advisable to implement lang="en" xml:lang="en_"_ in the HTML tag and http-equiv="content-language" content="en_"_ in the META tags?0 -
Implement rel canonical on a Blogspot blog
Does anyone know how to implement a rel canonical tag on a Blogspot blog? I am trying to pass link juice from an old Blogspot blog to a self-hosted website.
Technical SEO | | ProjectLabs0 -
Meta Description: How to Implement It?
I'm pretty new to SEO and am starting to implement the knowledge that I've learned into the websites that I'm working on. The websites have already been created but without Meta-descriptions. My problem is that when I try to implement a Meta Description it moves the whole website text and design. I am using Wordpress to manage and edit the sites. Any help would be great. Thanks!
Technical SEO | | amnistech1