For venues, planners and shops

Put a useful party finder where plans happen.

Give visitors a practical next step without rebuilding the catalog. Configure the card, preview it live, then copy one small iframe snippet into your site.

Live configurator

Build your embed

Only plain text, a validated color, a known occasion and a limited result count are accepted. Partner URLs must be explicit HTTPS or HTTP links.

Brand label Accent color Occasion Results Partner attribution URL, optional

Copyable iframe code

White-label guidance

Brand the handoff, keep the truth visible

You may use your own label and accent color so the card feels native to your venue, planner service or shop. White-label styling does not change the source of the ideas or the operator of the widget.

Keep a visible “Powered by ideas.party” label or a clear link to ideas.party.
Do not imply that ideas.party endorses your business, supplies your products or authored a partner’s service.
Use the optional attribution URL only for a real partner destination; invalid or non-HTTP links are ignored.
Do not inject partner HTML, scripts, tracking pixels or custom code into the iframe.

Partner use cases

A small finder for a real planning moment

Venues

Help a visitor turn a date, room or celebration brief into a complete plan they can discuss with your event team.

Use the dinner or seasonal occasion
Link the card to your booking or contact page
Keep your own brand label visible

Planners

Offer a lightweight discovery step before a consultation, with a consistent set of supplies and run-sheet details to discuss.

Use any occasion or birthday filters
Link to your planning guide
Keep the ideas.party attribution honest

Shops

Give customers a useful plan when they are looking for supplies, food, games or a themed setup rather than sending them to a generic homepage.

Use a three-result card for a shelf or sidebar
Link to your relevant service or product page
Do not collect leads inside the iframe

Implementation docs

One iframe, four safe controls

Host the iframe on an HTTPS page and load the production widget URL. The widget reads the existing ideas.party database in app.js, renders text nodes and links, and accepts no arbitrary HTML or scripts.

The public /widget route remains indexable as a WebPage because static delivery cannot know whether embed=1 is present. Embedded instances use the same route; apply any host-page robots policy on the surrounding page.

brand: plain text up to 40 characters.
accent: a six-digit hex color such as #e85d4a.
occasion: one known ideas.party occasion or any.
limit: an integer from 1 to 6.
attribution: optional explicit HTTP or HTTPS partner URL.

Embed example

Copy the generated code above. Set a meaningful title, keep the iframe responsive and do not remove the attribution label.

<iframe src="https://ideas.party/widget?brand=Your%20event&accent=%23e85d4a&occasion=seasonal&limit=3" title="Party idea finder" loading="lazy" width="100%" height="650" style="border:0;max-width:720px"></iframe>

Analytics

Useful events for partner reporting

The widget and configurator send non-personal GA4 events so a partner can see whether the finder is useful without collecting form leads inside the iframe.

Event	When it fires	Parameters
`widget_view`	The finder renders ideas.	`widget_occasion`, `widget_limit`, attribution presence.
`widget_select`	A visitor opens an idea plan.	`idea_id`, `widget_occasion`.
`partner_preview_update`	The partner configurator changes the preview.	`widget_occasion`, `widget_limit`.
`partner_embed_copy`	The iframe code is copied.	`widget_occasion`, `widget_limit`.