Configuring Calculator Defaults
How to pre-fill calculator fields with default values using URL parameters.
Pre-filling Values with URL Parameters
You can pre-fill calculator inputs using query string parameters in your embed URL. This is useful when you want to set sensible defaults for your audience.
Example
To pre-fill the Loan Repayment Calculator with a $500,000 loan amount at 6.5% interest:
?widgets=loan-repayment&loanAmount=500000&interestRate=6.5
Common Parameters
Loan Repayment Calculator
loanAmount— Loan amount in dollarsinterestRate— Annual interest rate (%)loanTerm— Loan term in yearsrepaymentFrequency—weekly,fortnightly, ormonthly
Stamp Duty Calculator
propertyValue— Property value in dollarsstate— Australian state code (e.g.NSW,VIC,QLD)firstHomeBuyer—trueorfalse
Borrowing Capacity Calculator
grossIncome— Annual gross incomeexpenses— Monthly living expenses
Display Configuration
Beyond calculator values, you can also configure display options:
view— Layout mode:tab,stack, orsingletheme— Colour theme:lightordarkwidgets— Comma-separated list of calculator slugs
Combining Parameters
You can combine multiple parameters:
?widgets=loan-repayment&view=single&theme=dark&loanAmount=750000&interestRate=6.2&loanTerm=30
Embedding with Defaults
Simply add the parameters to your iframe src URL. The calculators will load with the specified values pre-filled, and users can still modify them.
Related Articles
Full calculator catalogue (AU, NZ, US)
Every calculator available on CalcWidgets, grouped by region and use case, with IDs you can use in embed URLs.
Adding or removing calculators from your account
Turn calculators on or off yourself — no need to email support. Every calculator in the catalogue is included in your plan.
Available calculators overview
A short overview of the CalcWidgets calculator catalogue grouped by use case. For the full list with IDs, see the full catalogue.