JSON-LD for SEO is compatible with Shopify's Online Store 2.0
Ilana DavisA new version of JSON-LD for SEO’s app code has been developed to take advantage of new features rolled out with Shopify’s Online Store 2.0. The best part is that you don’t even need an Online Store 2.0 theme to take advantage of them.
The new JSON-LD or SEO version works on all themes.
Current customers of JSON-LD for SEO who need to migrate to the new snippet can follow the instructions below.
All new customers as of January 4, 2022, will be on the new version. As of April 2023, stores on the legacy code version are required to migrate to the new App Embed.
Migrate from old snippet
New Installs
Why do I care about Online Store 2.0 changes?
Do I have to be on a 2.0 theme to utilize Online Store 2.0 features?
Do I have to migrate to the App Embed for JSON-LD for SEO?
I have custom code in my theme, will migrating apps to the new version impact my store?
Migrate from the old snippet
JSON-LD for SEO can migrate the old-style snippet to the new App Embed Block. The whole process will take less than 2 minutes.
If you have already migrated successfully or I’ve emailed you specifically about the migration, thank you, no further action is needed.
To begin the migration, follow the steps below.
Step 1: Enable the app
In your theme settings, enable the Structured data JSON-LD App Embed from JSON-LD for SEO.
- Login to the JSON-LD for SEO app and select Migrate Snippet
- From the app, select the Theme Settings link
- Search for JSON-LD for SEO
- Enable the app in your theme’s App Embeds (toggle should be blue)
- Select Save
Remember to select Save at the end. This part has been catching a few folks during the migration process.
Step 2: Remove the old snippet
- After enabling the app in step 1, select Customize Settings in JSON-LD for SEO to return to the app page
- Select Remove old snippet and finish migration
Once complete, you can test your site to make sure JSON-LD for SEO’s code is running with this guide.
Alternative: manually remove the JSON-LD for SEO code
Liquid Error: Could not find asset snippet
JSON-LD for SEO will attempt to remove the old snippet code for you. You’ll know if we were unable to remove the code if you see {% include ‘jsonld-for-seo’ %} in the layout/theme.liquid file or if you see an error visually at the bottom of your homepage. The error is because the migration was successfully able to remove the old file, but unable to remove the include line from your layout/theme.liquid file.
If the migration process can’t safely remove edited or copied code, it won’t. This is so we don’t accidentally delete code that doesn’t belong to us.
Here are the steps for you to take to remove the code manually:
- From your theme customizer in the live theme go to Online Store – Actions – Edit Code
- Select the layout/theme.liquid file and search for jsonld-for-seo
- You should find a line of code that needs to be deleted
{% include ‘jsonld-for-seo’ %} - If you find any other lines of code like the following, they should also be removed. These are the copies/edits. Delete everything inside the curly brace.
{% include ‘jsonld-for-seo’ %} - Once that is deleted, select Save
When in doubt, don’t hesitate to email support@ilanadavis.com to make sure JSON-LD for SEO is set up and working correctly.
New Installs
If you are new to JSON-LD for SEO and want to take advantage of Online Store 2.0, you will get it by default when you install the app.
You will need to enable to App Embed Block but that’s it. The app will guide you through the install process, but it’s a quick 2 minute click around your Shopify admin to set up your theme.
If you want more details, including a fun animated gif with robots, here’s a more detailed article.
Frequently Asked Questions
Why do I care about Online Store 2.0 changes?
Shopify announced in 2021 the biggest set of infrastructure investments in Shopify history. The Online Store 2.0 update allows for more flexibility, speed improvements, and a slew of features to help stores increase conversions.
The Online Store 2.0 update makes it easier to add/remove apps without impacting theme code, adds sections to every template, more flexible theme settings, adds product and collection metafields natively to Shopify, and more to come.
JSON-LD for SEO’s Online Store 2.0 update allows us to give you the latest structured data improvements and optimizations while taking advantage of Shopify’s performance improvements.
Everyone likes better performance, right? It’s rhetorical. Don’t answer that.
Do I have to be on a 2.0 theme to utilize Online Store 2.0 features?
The update for JSON-LD for SEO is compatible with all Shopify themes, even non-Theme Store 2.0 themes.
Online Store 2.0 is actually a collection of different features, some of which are available to every single Shopify store. Others require apps and the theme to be upgraded to the new code.
Shopify made it so that all stores regardless of what theme you are on can access the App Embed Blocks which JSON-LD for SEO utilizes. App Embed Blocks are apps that do not visually display content on your page.
App Blocks are different and do require an Online Store 2.0 compatible theme and app. You’ll need to confirm with your theme that all templates are 2.0 compatible. App Blocks add content to visually display on your page.
You may find some apps that utilize both the App Embed Block and the App Blocks. (Could Shopify have made this any more confusing?) For example, review apps tend to use both. One for their main settings and the other to visually display the review widgets on the page.
One way to remember is that App Blocks are visible and have to be positioned on each page while App Embed Blocks are added to every page. Embedded apps don’t have a specific location.
To get the full experience and access to all features I recommend using an Online Store 2.0 theme at some point.
Do I have to migrate to the App Embed for JSON-LD for SEO?
For those who installed before January 4, 2022, you are required to migrate to the new App Embed. Though the old legacy JSON-LD for SEO code will still work, the old snippet will no longer receive updates or new features.
New installs of JSON-LD for SEO as of January 4, 2022, are already on the App Embed. You don’t need to migrate and you won’t see a migrate option. You will however need to enable the app in your theme as mentioned previously.
That means if Google decides to change its rules yet again in 2022 or beyond, only the new version of the app code will be updated.
I do recommend migrating to the new App Embed.
I have custom code in my theme, will migrating apps to the new version impact my store?
I can’t speak to all apps, only JSON-LD for SEO. We’ve done a lot of the work to make the migration as easy for you as possible. The entire migration process should take no longer than 5 minutes.
Custom code in your theme should not impact the migration process for JSON-LD for SEO unless you’ve altered our code in some way.
There are instructions above for you to manually remove the old snippet if you prefer.
If you need help and would like me to manually update it for you, please contact me at support@ilanadavis.com.
