I’m Duane Buziak, Mortgage Maestro, and this is the number your widget has to get right. Take a $1,200,000 purchase with 20% down ($240,000), which leaves a $960,000 loan on a 30-year fixed term. At an interest rate of 6.50%, principal and interest comes to about $6,068 a month. At 6.25% it is about $5,911, a difference of roughly $157 a month, or about $1,884 a year. This is illustrative only, not a quote, and it excludes taxes, insurance and any HOA dues.
A mortgage rate widget for a real estate website is an embedded calculator or rate display that shows visitors an estimated payment from a source they can trust. It works best when it is accurate, clearly dated, and ends in a soft pull pre-approval. A soft pull is a credit check that does not affect a credit score. You will finish with a live, compliant widget. Before you start, have website edit access (or a developer), a licensed broker partner, and the compliance wording from Step 5.
Byline: Duane Buziak, NMLS #1110647
In this guide
- Step 1: Decide what your widget needs to do for visitors
- Step 2: Choose a trustworthy data source and date-stamp it
- Step 3: Set the calculator inputs and defaults
- Step 4: Choose how to embed it: plugin, iFrame, or custom code
- Step 5: Add required disclosures and protect visitor data
- Step 6: Connect the widget to a soft pull pre-approval
- Step 7: Test, publish, and keep the widget current
- What to verify, and where to go from here
Step 1: Decide What Your Widget Needs to Do for Visitors
A mortgage rate widget for a real estate website can do three different jobs, and each answers one buyer question.
- Payment calculator: answers “what will this cost me each month?”
- Today’s-rates display: answers “where are rates right now?”
- Pre-qualification entry point: answers “can I qualify?”
Pick one primary job per page. Listing pages suit a payment calculator pre-filled with the list price. A rates page suits a dated rates display. A Realtor resource page suits a co-branded pre-qualification link, and the mortgage resources for real estate agents guide shows what else belongs on that page. Three tools crowded onto one page split attention and usually weaken all three.
Decide early how the widget talks about money. A widget that shows one rate invites the wrong comparison, because two buyers with different files rarely get the same terms. Lead with total monthly cost and closing certainty, and use the word “cost” rather than “rate” in your labels. “Estimated monthly cost” sets a better expectation than “Your rate.”
| Option | Who it fits | Documentation | Credit approach | Down payment and reserves as the official source states |
|---|---|---|---|---|
| Payment calculator | Visitors on a listing page who want a monthly figure | None collected; visitor enters estimates | No credit check | Varies by loan program; the calculator only models the amount you enter |
| Rate display | Visitors comparing the market | None collected | No credit check | Not applicable; shows a dated benchmark, not an offer |
| Soft pull pre-qualification entry point | Visitors ready to learn what they may qualify for | Pay stubs or business returns, asset statements, ID, depending on the file | Soft pull, no effect on credit score | Set by the program and, for jumbo, by the specific investor; approval depends on the file |
Step 2: Choose a Trustworthy Data Source and Date-Stamp It
For national context, use a published benchmark. Freddie Mac’s Primary Mortgage Market Survey (PMMS) is a widely cited weekly average. Show it with its as-of date every time. Pull the current figure and date on the day you publish; do not copy a number from an article, including this one.
Loan limits need the same discipline. The Federal Housing Finance Agency (fhfa.gov) publishes the conforming loan limit each year, along with higher limits for high-cost areas. A high-cost area limit is the larger county-level ceiling that applies where home prices run above the baseline. A jumbo loan is any loan above the limit for the property’s county. Your widget must switch its product assumptions at that line, because jumbo pricing, reserves and documentation differ from conforming loans. The jumbo versus conforming mortgage comparison explains that line in plain terms.
The most common mistake is a static rate typed into the page. It goes stale within days, and visitors will not know. Require either an automatic feed or a visible “as of” stamp, and name one person who owns updates.
| Item | Figure | Source link | As-of date |
|---|---|---|---|
| 30-year fixed national average (benchmark only, not an offer) | Read the current weekly figure from the PMMS page at publication | Freddie Mac PMMS | The survey date shown on the page when you retrieve it |
| Conforming and high-cost area limit for the property’s county | Read the current-year county figure from FHFA at publication | FHFA conforming loan limits | The limit year shown by FHFA when you retrieve it |
Record the retrieval date and URL beside each entry in your own files. That record is what you will check against in Step 7.
Step 3: Set the Calculator Inputs and Defaults
Include these fields: home price, down payment, loan term, interest rate, county property tax, homeowners insurance, mortgage insurance (PMI, required on many loans with under 20% down), and HOA dues. Leaving out taxes and insurance makes the output look smaller than the real monthly cost, which is exactly the flattering error to avoid. For more on what belongs in a payment tool, see the best mortgage calculators for buyers.
Set neutral defaults and label them illustrative. Never default to the most favorable figures, and never attach savings language to the output.
Here is the cost breakdown on the earlier scenario. Suppose a $1,200,000 purchase, $960,000 loan, 30-year term, 6.50% interest, an illustrative $12,000 annual property tax and $4,200 annual insurance. Illustrative only, not a quote.
| Principal and interest | County property tax (assessor link) | Insurance | PMI if any | Total monthly cost |
|---|---|---|---|---|
| $6,068 | $1,000 (illustrative; use the rate published by your county assessor) | $350 | $0 at 20% down | $7,418 |
The total is $6,068 + $1,000 + $350 = $7,418. Link the tax input to the assessor’s published rate for the county in question, and confirm it before you rely on it.
Build in a flag for loan size. When the entered loan exceeds the county limit from Step 2, show a plain note that the loan is in jumbo territory. Jumbo reserve and documentation requirements vary by investor, so approval depends on the file. Point visitors to the guide to reserves in a mortgage for the concepts behind that note.
Step 4: Choose How to Embed It: Plugin, iFrame, or Custom Code
There are three common methods. This comparison sticks to structural facts that hold in general.
| Factor | Plugin | iFrame | Custom code |
|---|---|---|---|
| Setup effort | Install and configure through your site’s admin | Paste one embed snippet | Developer builds and tests |
| Design control | Limited to the plugin’s settings | Limited; the content is styled by its host | Full control |
| Mobile behavior | Depends on the plugin; test it | Needs a responsive width setting | Whatever you build and test |
| Who maintains the data | The plugin provider, plus your updates | The host of the framed page | You, or your feed provider |
Whichever method you choose, set a responsive width so the widget fits a phone screen without sideways scrolling. Turn on lazy loading, which delays loading the widget until a visitor scrolls near it, so it does not slow the page. On a listing page, place it below the listing price. On a rates page, put it above the fold.
Platforms differ in what embed code they allow, and those rules change. Check your website platform’s documentation for permitted embed code and any “as of” feature changes before you commit to a method. I won’t name platform features here because they shift.
Do not embed a third-party script you cannot vet. Before installing anything, confirm who hosts the data, where visitor entries are sent, and who can change the script after you install it. If you cannot get clear answers, choose a different source. A page built around a mortgage rate comparison tool faces the same vetting questions.
Step 5: Add Required Disclosures and Protect Visitor Data
Place the disclosure next to the output, not buried in the footer. The wording should say that figures are estimates, not an offer or commitment to lend, and that approval depends on the file.
For licensing, state where the broker is licensed: VA, FL, TN, GA, DC, NC, SC, MD, TX and KY, plus WV. Never imply service anywhere else. Include NMLS #1110647 and a link to NMLS Consumer Access. Add the full compliance block from the end of this article beneath the widget or on the page it sits on. If you need to confirm which states are covered, the page on an independent mortgage broker licensed in multiple states lays it out.
The Consumer Financial Protection Bureau (consumerfinance.gov) publishes guidance on mortgage advertising, including how certain “trigger terms” (specific details about a loan’s terms) affect what an ad must also disclose. Read it, and have compliance counsel review your final wording and layout. I am not stating specific rule requirements here, because they depend on exactly what your widget displays.
On privacy, decide what the widget collects and say so. A calculator can work with no personal data at all. Do not collect Social Security numbers or credit data inside the widget itself; that belongs in the secure pre-approval process. Add a privacy policy link beside the widget and confirm that it matches what actually happens to visitor entries.
Step 6: Connect the Widget to a Soft Pull Pre-Approval
The widget’s final button should lead to the NoTouch Credit Pull soft pull pre-approval, which does not affect the visitor’s credit score. Link it to the soft credit mortgage approval page. Any pre-approval is subject to credit approval and underwriting guidelines, and the button text should not suggest otherwise. Visitors who are unsure of the difference between the two terms can read pre-approval vs pre-qualification first.
Here is what the visitor gets on the other side. I’m a broker, not a lender: I shop your loan across multiple wholesale lenders and compare your options, so a visitor sees several paths without a hard inquiry first. You can read about the way to shop mortgage rates before you link to it.
If you are a Realtor, add a co-branded link and a referral path so clients arrive with context and don’t have to repeat themselves. Call me at 804-212-8663 and we will set it up.
Tell visitors what to gather before they start:
- Pay stubs, or business returns if self-employed
- Bank and asset statements
- Government-issued ID
Timeline depends on the file. A salaried buyer with clean statements will move differently from a buyer with multiple income sources or asset-based income, so avoid promising speed in the button copy. Realtors who want to understand where delays come from can read about the common causes of mortgage closing delays.
Step 7: Test, Publish, and Keep the Widget Current
Before launch, run three scenarios through the widget: a conforming loan, a high-balance loan, and a jumbo loan. Re-derive each result by hand from the inputs and compare it to the displayed figures. If one is off by even a few dollars, find out why before publishing. Then test on a phone and with a screen reader.
Confirm that every “as of” date, county limit and tax input updates when its source changes. Put a monthly review on the calendar, and add a check whenever FHFA publishes new annual limits. If your page discusses timing, keep it consistent with your mortgage rate lock options content.
Track the metrics that matter:
- Widget interactions
- Click-through to the soft pull pre-approval
- Drop-off by device
Your own numbers after a few weeks will tell you more than any outside benchmark, so I won’t offer one.
If the layout breaks, check the width setting first, then look for script conflicts with other plugins or tracking tags. If figures look stale, check the data feed, then clear any page or browser caching that may be serving an old copy.
What to Verify, and Where to Go From Here
Before you publish, confirm three things: every date on the page matches its source, the county limits are current, and the disclosures sit beside the output. After that, the widget’s job is to hand a visitor to a real conversation.
Ready to see where you stand without putting your credit score at risk? Check today’s mortgage rates with a soft-pull pre-qualification and get personalized guidance from Duane Buziak, so you can move forward on your home purchase or refinance with confidence. You can also call 804-212-8663.
