Universal Integration

Header Scripts Integration Guide

The header script puts Schema.org markup into the head of your pages. It is the path for shops without an API, and it can also run on shops that are already connected via API.

Universal

Works with all shop systems

Simple

Just insert one code snippet

Safe

No theme modifications needed

Two paths, kept separate

Connected via API

Magento 1 and Magento 2
Wix, Squarespace, PrestaShop
Shopware, BigCommerce, Ecwid, OpenCart

Header script, no API

JTL-Shop, Gambio, OXID eShop
Any other or custom-built system

Step 1: Select Platform

Choose your e-commerce platform in the Libers Suite Dashboard.

Dashboard → Shops → Add Shop
Select your platform from the dropdown list. If your platform is not listed, choose "Other".

Step 2: Connect Shop

Connect your shop with Libers Suite - either via API or manually.

Option A: With API Access (recommended)

If your platform provides an API, you can automatically sync products.

Magento 1 and Magento 2: Admin Username + Password Guide →
Wix: API Key + Site ID Guide →
Squarespace: API Key Guide →
BigCommerce: Store Hash + Access Token Guide →
PrestaShop: API Key (enable Webservices) Guide →
Shopware: API Key + Secret Guide →
Ecwid: Store ID + Access Token
OpenCart: API Key

Option B: Without API Access

If no API is available, simply enter your shop URL. You can import products manually later.

Header scripts work even without API access. You just need to create products manually in Libers Suite.

Step 3: Synchronize Products

Import your products into Libers Suite.

A
With API:

Click "Synchronize" in the dashboard. Products will be imported automatically.

B
Without API:

Create products manually or import them via CSV.

Step 4: Generate Knowledge Packs

Create AI-optimized Knowledge Packs for your products.

1
Go to Dashboard → Products
2
Select products and click "Optimize for LLM"
3
Libers Suite analyzes product data and generates optimized descriptions

Step 5: Enable Header Script (IMPORTANT)

Activate header script publishing in shop settings.

  1. Go to Dashboard → Shops
  2. Click on your shop
  3. Scroll to "Publication Settings"
  4. Enable the toggle "Header Script"
What does the header script do?
It automatically injects Schema.org markup, meta tags, and Open Graph tags into your product pages. Crawlers see the optimized data - your customers see the normal page.

Step 6: Copy Code Snippet

Copy the generated JavaScript snippet from the dashboard.

Code Snippet Example:
<script src="https://cdn.libers.ai/llmo-sdk.js"
        data-api-key="your-api-token-will-appear-here">
</script>

Your personal API token will be generated automatically

Step 7: Insert Code into Shop Theme

Insert the code snippet into the <head> section of your shop theme.

Platform-specific Instructions:

Magento / Adobe Commerce:

Admin → Content → Design → Configuration → HTML Head → Scripts and Style Sheets

Wix:

Settings → Custom Code → Add Custom Code → Head

Squarespace:

Settings → Advanced → Code Injection → Header

BigCommerce:

Storefront → Script Manager → Create a Script → Placement: Head

PrestaShop:

Design → Theme & Logo → Advanced Customization → Custom Code → Header

Shopware:

Theme Manager → Edit Theme → Custom CSS/JS → Add to Head

Other Platforms:

Look in your theme editor for "Custom Code", "Header Scripts", or "HTML Head"

Important: The script must be inserted in the <head> section, not in the body. Only then can the meta tags be output correctly.

Step 8: Verification

Check if the script works correctly.

Verification Tools:

Page Source

Right-click on product page → "View Page Source" → Search for "llmo-sdk.js"

Google Rich Results Test

search.google.com/test/rich-results

Schema.org Validator

validator.schema.org

Frequently Asked Questions

Can I combine header scripts and API integration?

Yes! You can use both methods simultaneously. API for automatic product sync and header scripts for Schema.org markup output.

Does the script affect my shop's loading time?

No. The script is loaded asynchronously and has minimal overhead (~5KB). It affects neither loading time nor user experience.

What happens if I disable the script?

The Schema.org markup will no longer be output. Your products remain stored in Libers Suite and can be reactivated at any time.

Does the script work with every theme?

Yes. The script is theme-independent and works with all standard and custom themes, as long as you have access to the HTML head.