Migrate to the App Embed version of JSON-LD for SEO

A new version of JSON-LD for SEO’s app code has been developed to take advantage of new features rolled out by Shopify.

The new JSON-LD or SEO version works on all themes.

For those who installed the app 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.

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.

1. Login to the JSON-LD for SEO app and select Migrate Snippet
2. From the app, select the Theme Settings link
3. Search for JSON-LD for SEO
4. Enable the app in your theme’s App Embeds (toggle should be blue)
5. 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

1. After enabling the app in step 1, select Customize Settings in JSON-LD for SEO to return to the app page
2. 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:

1. From your theme customizer in the live theme go to Online Store – Actions – Edit Code
2. Select the layout/theme.liquid file and search for jsonld-for-seo
3. You should find a line of code that needs to be deleted
   {% include ‘jsonld-for-seo’ %}
4. 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’ %}
5. Once that is deleted, select Save

When in doubt, don’t hesitate to contact me to make sure JSON-LD for SEO is set up and working correctly.

Frequently Asked Questions

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.

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.

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 have custom code in my theme, will migrating apps to the new version impact my store?

We’ve done a lot of the work to make the migration as easy for you as possible. The entire migration process should take around 2 minutes at most.

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.