Embed URL parameters reference

Every CalcWidgets embed is just one URL with query parameters. The dashboard generates these for you, but if you'd rather hand-craft URLs (or pre-set things differently on different pages of your site), here's the full list.

URL pattern

https://yourname.calcwidgets.com/embed?widgets=<ids>&view=<layout>

All supported parameters

Parameter	What it does	Example
widgets	Comma-separated calculator IDs to show	widgets=loan-repayment,stamp-duty
view	Layout mode (see below)	view=tab
theme	Predefined theme	theme=light
primaryColor	Override your brand primary colour for this embed only. URL-encode the hex	primaryColor=%230047AB
font	Override the font for this embed	font=Inter
logo	Override the logo URL for this embed (URL-encoded)	logo=https%3A%2F%2Fexample.com%2Flogo.png
cta	Override the CTA button label for this embed	cta=Book%20a%20call
defaultCalc	Which calculator opens first (only used in tab, dropdown, grid layouts)	defaultCalc=refinance

Required vs optional

You only need widgets. Everything else is optional — your dashboard defaults fill in for any missing parameter.

Override hierarchy

URL parameters always beat your dashboard defaults. So if you set primary colour to blue on the Branding page, but pass primaryColor=%23E11D48 (red) on a specific embed, that embed shows red. Useful for making one calculator stand out (e.g. red CTA on your refinance landing page) without touching your global brand.

Common combinations

One calculator only:

?widgets=loan-repayment&view=single

Three calculators in tabs:

?widgets=loan-repayment,stamp-duty,lmi&view=tab

Three calculators, refinance selected by default:

?widgets=loan-repayment,refinance,lmi&view=tab&defaultCalc=refinance

Different brand colour for one page:

?widgets=refinance&view=single&primaryColor=%232E7D32

Custom CTA on one embed:

?widgets=loan-repayment&view=single&cta=Get%20a%20pre-approval

URL-encoding values

Anything that contains special characters (the # in a hex code, spaces in text, slashes in URLs) needs URL-encoding. Most tools do this automatically:

• # → %23
• space → %20
• / → %2F
• : → %3A

The dashboard does this for you when generating embed codes. If you hand-craft URLs, just paste them into a browser and they'll work even when not encoded — but encode them if you're putting them inside an iframe src.