Work With Us

Widget Installation Guide

For partners looking for tech support

Embed the Inciteful Med medical Q&A widget directly on your website. Your visitors can ask medical questions and receive literature-backed answers without leaving your site.


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: "Ask Medical Question"

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();
    }
});

Rate Limits

Each partner has a daily question limit configured in your account:

  • Anonymous users can ask questions without creating an account

  • Questions are rate-limited per browser/device

  • When the limit is reached, users are prompted to create a free account for unlimited access

  • Your specific daily limit is shown in the widget when users reach their quota

Contact Inciteful Med to adjust your daily question limit.


Privacy & Compliance

The Inciteful Med widget:

  • ✅ Uses anonymous browser fingerprinting (no personal data required)

  • ✅ Clearly displays Terms of Service and Privacy Policy links

  • ✅ Includes medical disclaimer: "Inciteful Med is a knowledge tool. Please use in consultation with your doctor."

  • ✅ Does not store personal health information without user consent


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 Shows "Partner Not Found" Error

Widget Shows "Partner Inactive" Error

  • Your partner account has been deactivated

  • Contact Inciteful Med to reactivate

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 "Ask Medical Question" Text displayed on the floating button