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:
Script placement: Ensure the script is before the closing
</body>tag, not in<head>Partner ID: Verify your
data-partner-idis correct (no typos)Browser console: Open browser DevTools (F12) and check for JavaScript errors
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 |