Widget Documentation

The MotR Widget Platform lets you embed free vehicle lookup tools on any website. The widget is a lightweight JavaScript loader (~12KB) that scans your page for data-motr-widget elements and renders a premium search interface inside them.

When a visitor enters a registration, the widget queries official DVLA & DVSA data via MotR's API, displays a preview card with key vehicle details, and provides a button to view the full report on MotR.

Key features: No dependencies, under 30KB, mobile responsive, dark/light/auto themes, full customisation, analytics tracking, and mandatory "Powered by MotR" attribution.

Add the MotR widget to your website in three simple steps:

Step 1: Add the script tag before your closing </body> tag:

<script src="https://motr.uk/functions/serveWidgetEmbed"></script>

Step 2: Add the widget div anywhere on your page:

<div data-motr-widget="vehicle-report"
  data-motr-theme="dark"
  data-motr-accent="#2563eb">
</div>

Step 3: That's it. The widget auto-initialises and is ready to use.

All options are set via HTML data attributes on the widget div:

The widget supports three theme modes:

• dark — Glassmorphism dark card with deep navy gradient. Best for dark websites.
• light — Clean white card with subtle shadow. Best for light backgrounds.
• auto — Automatically follows the visitor's system preference.

You can also customise the accent colour to match your brand. Use any valid hex colour:

<div data-motr-widget="vehicle-report"
  data-motr-theme="dark"
  data-motr-accent="#7c3aed">
</div>

The widget automatically tracks the following events to MotR's analytics dashboard:

Analytics include referring domain, page URL, device type, browser, operating system, and country — all GDPR-compliant with no personal data stored.

If you have a partner API key, analytics are attributed to your account and visible in your partner dashboard.

To prevent abuse, the widget enforces rate limits:

• Anonymous (no API key): 30 lookups per hour per IP address.
• Free plan (with API key): 1,000 lookups per month.
• Pro plan: 10,000 lookups per month.
• Enterprise plan: 100,000 lookups per month.

Rate limits reset automatically. If you need higher limits, contact MotR support to discuss an Enterprise plan.

The MotR Widget Platform includes multiple layers of security:

• API Key Validation: Optional API keys validate partner status and enforce domain restrictions.
• Domain Validation: Partner API keys can be restricted to specific domains.
• Bot Detection: Known bots, crawlers and headless browsers are blocked from lookups.
• Rate Limiting: IP-based and partner-based limits prevent abuse.
• No Full Plates Stored: Registrations are masked (e.g. AB12***) before analytics storage.
• CORS Headers: Proper cross-origin headers ensure secure browser communication.
• No Duplicate Content: The widget renders client-side only — no server-side HTML that could be indexed by search engines as duplicate content.