Skip to main content

Google Tag Manager

Use GTM if your team deploys tags through Tag Manager and can’t modify the site’s codebase directly.
GTM injects scripts at runtime, so schemas are client-injected and automatic detection is not possible. After publishing your container, you must manually confirm the integration in the InstantSchema dashboard.

Setup

1. Create a new tag

In your GTM workspace, go to Tags → New.

2. Choose Custom HTML

Select Custom HTML as the tag type.

3. Paste the CDN snippet

Copy the CDN tag from the CDN tab of your InstantSchema integration panel, and paste it into the HTML field:
<script
  src="https://app.instantschema.com/v1/loader.js"
  data-project-id="YOUR_PROJECT_ID"
  async
></script>

4. Set the trigger

Set the trigger to All Pages so the tag fires on every page view.

5. Save and publish

Click Save, then Submit and publish your container.

6. Mark as active in the dashboard

Because GTM injects at runtime, the InstantSchema dashboard can’t detect it automatically. Once your container is published:
  1. Open your project in the InstantSchema dashboard
  2. In the integration panel, click Mark as active
  3. Confirm in the dialog
The panel will show Integration active · via Google Tag Manager.

Disabling

If you later remove the GTM tag, click Disable in the integration panel to reset the status so detection runs again.