Partner Widgets

Drop-in, brand-styled widgets backed by the public Provider Directory API — one script tag, no key.

Partner Widgets are pre-built custom elements that embed directly in any HTML page or web app. They are powered by the same public Provider Directory API documented here — no API key, no server-side setup, no CORS configuration. Load a single script tag and drop in a tag wherever you need it.

Open by default, branded when you want

All widgets work without any configuration. Add a partner="yourname" attribute to enable attribution — it appends your identifier to sign-up CTAs and booking URLs so conversions are credited to your integration.

Quick start

Add one script tag in your page <head>, then place whichever widget tags you need in the body:

<script type="module" src="https://public.mymenopauserx.com/widgets/v1/embed.js"></script>

<mmrx-clinician-directory state="FL" theme="branded" layout="list"></mmrx-clinician-directory>

That's it. The script is an ES module — the type="module" attribute is required.

Clinician Directory

A searchable, filterable grid or list of Menopause Society Certified clinicians. Supports state, insurance, and provider-type filtering. Ideal for embedding a "find a provider near me" experience on a patient-facing page.

<mmrx-clinician-directory
  state="FL"
  theme="branded"
  layout="list"
  size="full"
></mmrx-clinician-directory>

Attribute	Values	Default
`state`	Two-letter US state code (`FL`, `IL`, `CT`, …)	(all states)
`layout`	`list` \| `grid`	`list`
`theme`	`branded` \| `neutral`	`branded`
`size`	`full` \| `compact`	`full`
`insurance`	Insurance slug (from `/v1/insurances`)	(no filter)
`provider-type`	`physician` \| `nursePractitioner`	(all types)
`partner`	Your partner identifier	(none)
`accent`	Hex or CSS color	(theme default)

StateLayoutThemeSize

Clinician Profile

A single provider's full public profile — headshot, credentials, bio, clinical interests, accepted insurance by state, and a booking CTA. Pass a provider slug (from /v1/providers) to identify the clinician.

<mmrx-clinician-profile
  slug="barbra-hanna"
  theme="branded"
  size="full"
></mmrx-clinician-profile>

Attribute	Values	Default
`slug`	Provider slug from `/v1/providers`	(required)
`theme`	`branded` \| `neutral`	`branded`
`size`	`full` \| `compact`	`full`
`partner`	Your partner identifier	(none)
`accent`	Hex or CSS color	(theme default)

Finding a slug

Provider slugs come from the slug field on any /v1/providers response. They are stable and human-readable (e.g. barbra-hanna).

ProviderThemeSize

Appointment Types

Lists the visit types available in a state — each with its name and modality (video or async). Use this to show patients what kinds of appointments are bookable before they sign up.

<mmrx-appointment-types
  state="FL"
  theme="branded"
  size="full"
></mmrx-appointment-types>

Attribute	Values	Default
`state`	Two-letter US state code	(all states)
`dense`	`true` \| `false`	`false`
`theme`	`branded` \| `neutral`	`branded`
`size`	`full` \| `compact`	`full`
`partner`	Your partner identifier	(none)

StateDenseThemeSize

Next Available

Surfaces the next open appointment slot in a state — ideal as a banner or a stat call-out to drive urgency on a landing page or sidebar.

<mmrx-next-available
  state="FL"
  theme="branded"
  variant="banner"
></mmrx-next-available>

Attribute	Values	Default
`state`	Two-letter US state code	(required)
`variant`	`banner` \| `stat`	`banner`
`theme`	`branded` \| `neutral`	`branded`
`size`	`full` \| `compact`	`full`
`partner`	Your partner identifier	(none)
`accent`	Hex or CSS color	(theme default)

StateVariantThemeSize

Book Visit

A complete booking initiation flow — the patient selects a state, a visit type, and lands in the sign-up funnel. Designed to be dropped in as an inline panel or a modal trigger.

<mmrx-book-visit
  state="FL"
  theme="branded"
  size="full"
></mmrx-book-visit>

Attribute	Values	Default
`state`	Two-letter US state code	(no preselection)
`theme`	`branded` \| `neutral`	`branded`
`size`	`full` \| `compact`	`full`
`partner`	Your partner identifier	(none)
`accent`	Hex or CSS color	(theme default)

StateThemeSize

Theming & attribution

Visual theming

Every widget accepts three style attributes:

Attribute	Purpose
`theme="branded"`	MyMenopauseRx brand colors (default)
`theme="neutral"`	Greyscale palette — blends with your own design system
`size="full"` \| `size="compact"`	Full-width vs. condensed layout
`accent="#hex"`	Override the primary accent color regardless of theme

Partner attribution

Add partner="yourname" to any widget. When present, all sign-up and booking CTAs generated by the widget will carry your partner identifier as a ref parameter and a UTM tag. This is how conversions are tracked back to your integration — no separate API call needed.

<mmrx-clinician-directory
  state="FL"
  partner="acme-health"
  theme="neutral"
></mmrx-clinician-directory>

Partner identifiers are assigned by the MyMenopauseRx partnerships team. Reach out to get one.

On this page