Widget Installation Guide – Incitefulmed

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:

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

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

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

Adblockers: Some adblockers may block third-party widgets

Widget Shows "Partner Not Found" Error

Your partner ID is incorrect or not yet activated

Contact hello@incitefulmed.com with your partner ID

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