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:
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 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 |