Work With Us

Widget Installation Guide

For partners looking for tech support

Last reviewed 2026-10-22

Embed the Inciteful Med question box on your website. Your visitors type a health question, and Inciteful Med opens in a new tab, where they create a free account (or sign in) and get a literature-backed answer with citations.


Quick Start

It takes just 30 seconds to add the Inciteful Med widget to your website.

Step 1: Get Your Partner ID

Contact Inciteful Med to receive your unique partner ID (e.g., your-organization-name).

Step 2: Add the Widget Code

Copy and paste the following code right before the closing </body> tag of your website:

<!-- IncitefulMed Health Widget -->
<script src="https://widget.incitefulmed.com/incitefulmed-widget.js"
        data-partner-id="your-organization-name"
        async></script>

Replace your-organization-name with your actual partner ID.

Step 3: That's It!

The widget will automatically appear as a fixed tab on the right side of your website.


Example Installation

Here's what your HTML should look like:

<html>
 <head>
  <title>Your Medical Practice</title>
</head>
<body>
 <h1>Welcome to Our Practice</h1>
 
  <!-- Your website content -->

  <!-- IncitefulMed Widget - Add before closing body tag -->
  <script src="https://widget.incitefulmed.com/incitefulmed-widget.js"
        data-partner-id="your-organization-name"
        async></script>
</body>
<html>

Configuration Options

Customize the widget to match your website's design and user experience preferences.

Change Button Position

Control where the widget button appears on your page.

Options:

  • side_right (default)

  • side_left

Example:

<script src="https://widget.incitefulmed.com/incitefulmed-widget.js"
        data-partner-id="your-organization-name"
        data-button-position="side_left"
        async></script>

Customize Button Text

Change the text displayed on the floating button.

Default: "Health Answers"

Example:

<script src="https://widget.incitefulmed.com/incitefulmed-widget.js"
        data-partner-id="your-organization-name"
        data-button-text="Get Medical Answers"
        async></script>

Full Custom Configuration Example

<script src="https://widget.incitefulmed.com/incitefulmed-widget.js"
        data-partner-id="your-organization-name"
        data-button-text="Medical Questions"
        data-button-position="side_left"
        async></script>

JavaScript API

Control the widget programmatically using JavaScript.

Available Methods

The widget exposes a global IncitefulmedWidget object with the following methods: show()

show()

Opens the widget dialog.

window.IncitefulmedWidget.show();

hide()

Closes the widget dialog.

window.IncitefulmedWidget.hide();

toggle()

Opens the widget if closed, closes it if open.

window.IncitefulmedWidget.toggle();

Example: Open Widget from Custom Button

<button onclick="window.IncitefulmedWidget.show()">
    Ask a Medical Question
</button>

Example: Toggle Widget on Page Load

// Wait for widget to load
window.addEventListener('DOMContentLoaded', function() {
    // Open widget automatically after 3 seconds
    setTimeout(function() {
        if (window.IncitefulmedWidget) {
            window.IncitefulmedWidget.show();
        }
    }, 3000);
});

Example: Close Widget After User Action

// Close widget when user clicks outside
document.addEventListener('click', function(event) {
    if (event.target.id === 'close-widget') {
        window.IncitefulmedWidget.hide();
    }
});

Accounts and Question Limits

Every visitor needs a free Inciteful Med account to see an answer:

  • When a visitor presses Continue, Inciteful Med opens in a new tab with their question filled in

  • They create a free account, or sign in if they already have one, and their question is asked straight away

  • Their research is saved to their own account, and their questions count against their own plan's allowance, not yours (see What are question quotas?)


Privacy & Compliance

The Inciteful Med widget:

  • ✅ Sets no cookies and stores nothing on your website

  • ✅ Sends nothing to Inciteful Med until a visitor presses Continue

  • ✅ Does not embed Inciteful Med in your page: answers, accounts and health information stay with Inciteful Med, under our Privacy Policy


Troubleshooting

Widget Not Appearing

Check these common issues:

  1. Script placement: Ensure the script is before the closing </body> tag, not in <head>

  2. Partner ID: Verify your data-partner-id is correct (no typos)

  3. Browser console: Open browser DevTools (F12) and check for JavaScript errors

  4. Adblockers: Some adblockers may block third-party widgets

Widget Not Loading on Mobile

  • Ensure you're not using any mobile-specific script blockers

  • The widget is fully responsive and works on all devices


Support

Need help with integration?

Email: hello@incitefulmed.com

Response time: Within 24 hours


Complete Configuration Reference

All available data-* attributes:

Attribute Type Default Description
data-partner-id String (required) Your unique partner identifier
data-button-position String side_right Position of floating button: side_right or side_left
data-button-text String "Health Answers" Text displayed on the floating button