Setup guide

Install the OVOX widget

One snippet, any platform. Copy your personalized code from the dashboard, paste it where this guide shows, and your widget goes live.

Updated May 2026 · 5 min read

On this page

Your installation code

Find your personalized snippet in the OVOX dashboard under Website Widget. It already includes your widget key.

HTML
<script src="https://widget.ovox.ai/w.js" data-widget-key="YOUR_WIDGET_KEY" defer></script>

Before installing, make sure your website domain is listed in Allowed domains in the dashboard. The widget will not load on unlisted domains.


WordPress

Two options: the Code Snippets plugin (safer) or editing functions.php directly.

Option 1 — Code Snippets plugin (recommended)

  1. Install the Code Snippets plugin from the WordPress Plugin Directory.
  2. Go to Snippets > Add New.
  3. Name it OVOX Widget.
  4. Paste this code, replacing the comment with your snippet:
PHP
function add_ovox_widget() {
  ?>
  <!-- Paste your OVOX widget snippet here -->
  <?php
}
add_action('wp_footer', 'add_ovox_widget');
  1. Set the snippet to run on the front end only.
  2. Save and activate.

Option 2 — functions.php

  1. Go to Appearance > Theme File Editor.
  2. Open functions.php for the active theme.
  3. Paste the same wrapper code at the end of the file.
  4. Replace the comment with your real OVOX snippet.
  5. Click Update File.

If you use a child theme, add the code there so it survives theme updates.


Drupal

Place the widget inside a custom block in your footer region.

  1. Go to Structure > Block layout.
  2. Click Place block in the Footer region.
  3. Choose Add custom block.
  4. Name it OVOX Widget.
  5. Switch the text format to Full HTML.
  6. Paste your OVOX snippet from the dashboard.
  7. Set visibility rules if needed, then save.

If the widget does not appear, clear Drupal cache and hard-reload the page.


Magento (Adobe Commerce)

Create a CMS block for the widget, then render it near the bottom of the page template.

Step 1 — Create the CMS block

  1. Go to Content > Blocks > Add New Block.
  2. Title: OVOX Widget. Identifier: ovox_widget.
  3. Store view: All Store Views or the relevant stores only.
  4. Paste your OVOX snippet into the content field and save.

Step 2 — Render the block

Add to your footer template (footer.phtml):

PHP
<?php echo $this->getLayout()->createBlock('Magento\Cms\Block\Block')->setBlockId('ovox_widget')->toHtml(); ?>

Or via Layout XML:

XML
<referenceContainer name="before.body.end">
  <block class="Magento\Cms\Block\Block" name="ovox.widget">
    <arguments>
      <argument name="block_id" xsi:type="string">ovox_widget</argument>
    </arguments>
  </block>
</referenceContainer>

Wix

Use the Custom Code area for a site-wide install.

  1. Open your Wix dashboard > Settings.
  2. Scroll to the advanced section > Custom Code.
  3. Click Add Custom Code, paste your snippet.
  4. Settings: Name OVOX Widget, pages All pages, placement Body - end.
  5. Apply and publish the site.

Custom code only works on published sites with a connected domain. Draft previews are not enough.


Squarespace

Use Code Injection for a site-wide or per-page install.

Site-wide install

  1. Open Settings > Advanced > Code Injection.
  2. Paste the OVOX snippet into the Footer field.
  3. Save.

Specific pages only

  1. Hover over the page > click the settings gear > Advanced.
  2. Add the snippet in the page-level code injection area.
  3. Save and publish.

Code Injection availability depends on the Squarespace plan.


Joomla

Install via a Custom HTML module or directly in the template.

Custom HTML module (recommended)

  1. Go to Extensions > Modules > New.
  2. Choose Custom HTML.
  3. Title: OVOX Widget. Show title: Hide. Position: a footer position.
  4. Paste your OVOX snippet in the content field.
  5. Publish and use menu assignment rules if needed.

Template-level install

  1. Go to System > Site Templates.
  2. Open the active template and edit index.php.
  3. Paste the snippet before the closing </body> tag.

GoDaddy Website Builder

Install through the site-wide code area in your editor settings.

  1. Open the website editor > Settings.
  2. Find Head HTML, Site-wide Code, or the custom code area available on that plan.
  3. Paste the OVOX snippet.
  4. Save and republish the website.

If the code field is hidden on the current plan, you may need to add the snippet from a higher-permission account.


Webflow

Both site-wide and per-page installs are supported.

Site-wide custom code

  1. Open Project Settings > Custom Code.
  2. Paste the snippet in the section that renders before </body>.
  3. Save and publish.

Per-page embed

  1. Open the page in the Webflow Designer.
  2. Drag an Embed element onto the page.
  3. Paste the snippet, save, and publish.

For sites where the widget should appear everywhere, use the site-wide method instead of repeating embeds page by page.


JavaScript frameworks

Same idea everywhere: place the snippet in the shared HTML or layout that loads across the whole site.

React
Add to public/index.html before </body>.
Next.js
Add once in the shared root layout or app shell that wraps every page.
Vue
Use the root HTML template or the top-level layout. Place near the end of the body.
Angular
Add to src/index.html before the closing </body> tag.

For other frameworks, the same rule applies: install the snippet in the shared layout or HTML template that renders on every page where the widget should appear.


Troubleshooting

Widget not appearing

  1. Make sure you copied the personalized snippet from your dashboard, not an example snippet.
  2. Confirm the website domain is listed in Allowed domains.
  3. Clear browser cache and any site cache or optimization plugin.
  4. Check browser developer tools for JavaScript errors.
  5. Make sure the script is loading on the live site, not only on a draft or preview.

Widget conflicts or broken page behavior

  1. Move the widget script lower so it loads near the end of the page.
  2. Check whether another script on the page is failing first and stopping the rest of the page from running.
  3. Publish the site again after removing duplicate or outdated widget code.

Need help?

If the widget still does not load after the steps above, contact us with enough detail to troubleshoot it quickly:

  • Your website URL
  • The email address tied to your OVOX account
  • Screenshots of the page or any error messages
  • The platform or framework your website uses

Email contact@ovox.ai if you need a fresh widget snippet or want us to install it with you on a screenshare.