Skip to content

Docs

VoxelEon-shopify for Shopify

Shopify only lets store apps install themselves, so for now VoxelEon adds to your store through your theme. You choose between a theme section with settings (download below) or a single pasted snippet that your VoxelEon dashboard prepares and verifies for you.

Download VoxelEon-shopify (.zip)

Works on any Shopify plan and Online Store 2.0 themes such as Dawn.

Option A: the theme section

  1. In Shopify admin open Online Store → Themes → Edit code on your live theme.
  2. Under Sections choose Add a new section, name it voxeleon-chat, and paste the contents of sections/voxeleon-chat.liquid from the zip.
  3. Press Customize, scroll to the footer, add the VoxelEon chat section, and paste your website token. Set position, launcher label, dark mode and language there.

Option B: one pasted snippet, with verification

In VoxelEon open Settings → Inboxes, your website inbox, and the Shopify tab. Enter your store address, copy the snippet, and paste it into layout/theme.liquid just above </body>. Press Verify installation: VoxelEon waits for the widget to load and also looks for the snippet on your storefront.

Once confirmed, the widget is locked to your store address and myshopify.com, so your token cannot be used on someone else's site.

Password-protected stores

While Online Store password protection is on, VoxelEon cannot reach your storefront and verification will say it cannot be reached. Remove the password, then verify again.

Hide the launcher on a page type

With the pasted snippet (Option B), put this in theme.liquid above the VoxelEon snippet, changing the template name as needed. The theme section sets its own options, so use its settings instead.

{% if template.name == 'cart' %}
  <script>window.voxeleonSettings = { hideMessageBubble: true };</script>
{% endif %}

What is not included yet

Customers are not identified automatically, and the AI cannot look up orders yet. If you switch themes, add the section or snippet to the new theme. We plan a full Shopify app later, which will remove these limits.

Send form submissions to VoxelEon (optional)

Your site builder's forms can send leads to VoxelEon through Zapier. In the same VoxelEon tab press Create a key for Zapier and copy it (it is shown once). In Zapier add a Webhooks by Zapier action: a POST to https://app.voxeleon.com/api/v1/connect/leads with the header Authorization: Bearer YOUR_KEY, an Idempotency-Key header set to the form entry id, and name, email, phone (international format) and message in the body. Each submission appears as a contact with a conversation labelled with the platform.

Need help?

Email hello@voxeleon.com and we'll help you get the widget live.