Magento AI Support Lite docs

Install snippet

<script>
(function () {
  function loadMagentoAiSupportWidget() {
    var s = document.createElement('script');
    s.src = 'https://ai-support.magentoservicesapp.com/widget.js';
    s.async = true;
    s.dataset.shopKey = 'pk_mas_your_public_key';
    s.onerror = function () {};
    document.head.appendChild(s);
  }

  if ('requestIdleCallback' in window) {
    window.requestIdleCallback(loadMagentoAiSupportWidget, { timeout: 3000 });
  } else {
    window.addEventListener('load', loadMagentoAiSupportWidget, { once: true });
  }
})();
</script>

Domain allowlist

Widget requests are accepted only when Origin/Referer host matches primary domain or allowed domains list.

BYOK security

OpenAI keys are stored encrypted server-side and are never sent to the browser.

GraphQL/REST connectivity test

Use merchant portal action Test GraphQL. REST is used only when an integration token is configured.

Troubleshooting WAF / Cloudflare

If widget requests are blocked, allowlist AI Support server IPs in your firewall/WAF policy, and keep the storefront domain in shop allowlist.

Lite limits

• No embeddings or vector database in v1.
• Catalog result page size capped to 10.
• Magento timeout up to 8 seconds, OpenAI timeout up to 30 seconds.

How to disable

Disable per shop in portal, or set global maintenance in Ops panel. Widget will display offline message automatically.