Skip to content

Integration guide

Asklify + Shopify

Add the widget to your storefront theme in under two minutes — no app installation required. Your assistant can answer shipping, returns, and product questions trained on your store's pages and policies.

Prerequisite: an Asklify project with some knowledge added — the quickstart covers that in a couple of minutes. You'll need your public project ID (pub_...) from Widget → Install.
1

Open your theme's layout

In Shopify admin go to Online Store → Themes → ⋯ → Edit code, then open layout/theme.liquid.

2

Paste the snippet before </body>

layout/theme.liquid
    <! Asklify assistant >
    <script
      src="https://api.asklify.in/widget.js"
      data-project-id="pub_YOUR_PROJECT_ID"
      defer
    ></script>
  </body>
</html>
3

Add your store's domain to the allowlist

In Asklify's widget settings, add your myshopify.com domain and your custom domain so only your store can embed the assistant.

4

Train on your store content

Point Website ingestion at your store's sitemap (yourstore.com/sitemap.xml) to index products, policies, and FAQ pages automatically.

Ready-to-use template

Copy, paste, replace the project ID — that's the whole integration:

snippets/asklify.liquid
{% comment %}
  Asklify chat assistant — include with {% render 'asklify' %} just
  before </body> in layout/theme.liquid. Toggle per-template if needed.
{% endcomment %}
{% unless template contains 'checkout' %}
  <script
    src="https://api.asklify.in/widget.js"
    data-project-id="pub_YOUR_PROJECT_ID"
    defer
  ></script>
{% endunless %}
As a reusable snippet: create snippets/asklify.liquid, then {% render 'asklify' %} in theme.liquid.

Customization

All appearance and behavior — name, greeting, colors, theme, position, suggested questions — is configured in your dashboard under Widget settings and applies instantly without redeploying. See the widget configuration reference.

Event handling

To react to what happens in conversations — a chat starting, a customer requesting a human, feedback submitted — subscribe to webhooks. For fully custom experiences, the REST API exposes chat with streaming, knowledge search, and conversation transcripts.

Best practices

  • Exclude checkout (as the snippet does) — Shopify restricts third-party scripts there anyway.
  • Re-crawl after big catalog changes, or schedule sync from the Website page.
  • Use suggested questions like “What's your return policy?” to guide shoppers.

Troubleshooting

  • Widget on some pages only — ensure the snippet is in theme.liquid (the global layout), not a template.
  • Not showing after theme update — theme updates can overwrite theme.liquid; re-add the snippet or keep it in a snippet file.

Still stuck? Check the error reference or email hello@asklify.in.