FAQ & Troubleshooting

Answers to frequently asked questions about the Exlitem search widget.

#Widget Not Loading?

Check your API key. Make sure the api-key attribute matches your publishable key exactly. It should start with exl_pub_live_ for production or exl_pub_test_ for testing.

Check the script tag. The widget script must be loaded on the page. Verify the <script> tag is present and pointing to the correct URL. Check the browser console for 404 errors.

Check for JavaScript errors. Open your browser's developer console (F12) and look for error messages. Common issues include Content Security Policy (CSP) restrictions blocking the script.

#CORS Errors?

If you see CORS-related errors in the console, your domain may not be in the allowed domains list for your affiliate account.

Solution: Contact your administrator to add your domain to the allowlist. Both www.example.com and example.com must be added if you use both.

If you're developing locally, localhost is automatically allowed for test API keys.

#Rate Limited?

The widget shows a "Rate limited" message when you've exceeded your tier's rate limit (requests per minute) or daily search quota.

Quick fixes:

• Wait a minute for the per-minute rate limit to reset
• Daily limits reset at midnight UTC
• Consider upgrading to a higher tier if you consistently hit limits

Check your tier limits on the Tiers page.

#Can I Style the Widget?

Yes. The widget supports several customization options:

• Theme: Set theme="light", theme="dark", or theme="auto"
• Brand color: Set primary-color="#your-color" to change the accent color
• CSS variables: Override --exlitem-* variables for fine-grained control

See the Theming guide for details.

The widget uses Shadow DOM, so your page's CSS won't accidentally affect it, and its styles won't leak into your page.

#Multiple Widgets on One Page?

Yes. You can place multiple <exlitem-search> elements on the same page, each with different configurations:

<exlitem-search api-key="YOUR_KEY" specialty="Patent Litigation"></exlitem-search>
<exlitem-search api-key="YOUR_KEY" specialty="Medical Malpractice"></exlitem-search>

The script only needs to be loaded once. Each widget instance operates independently.

#Does It Work on Mobile?

Yes. The widget is fully responsive and adapts to screen widths down to 320px. On narrow screens, the layout adjusts automatically — result cards stack vertically and the search input takes full width.

#Can I Use It in a Single-Page App (SPA)?

Yes. The widget is a standard Web Component (Custom Element). It works in React, Vue, Angular, Svelte, and any other framework. When the element is added to the DOM, it initializes automatically.

If you dynamically add/remove the widget, it properly cleans up event listeners and tracking when disconnected from the DOM.

#What Data Do You Collect?

The widget collects only usage events (impressions, searches, clicks) tied to your API key. It does not:

• Set cookies
• Use local storage
• Collect visitor personal information
• Track visitors across sites
• Use fingerprinting

Events are sent to Exlitem's servers and used solely for analytics and attribution.

#My API Key Was Compromised

If you believe your API key has been exposed or misused:

1. Contact your administrator immediately
2. They can rotate your keys from the admin dashboard
3. New keys are generated instantly; old keys expire after a grace period
4. Update the api-key attribute on your site with the new publishable key

You do not need to change your secret key if only the publishable key was exposed — publishable keys are designed to be used in client-side code.