Skip to content
Calcadian logoCalcadian

Widgets

A widget is an iframe that runs a working Calcadian calculator inside your page. There are two kinds, and the difference matters.

Free embeds

Any calculator can be embedded by adding ?embed=1 to its URL. No account, no configuration, no limits, and a small Calcadian credit stays visible.

<iframe
  src="https://calcadian.com/business-days-calculator?embed=1"
  width="100%" height="520" style="border:0"
  title="Business days calculator"></iframe>

Saved widgets

A saved widget is created in the builder and stored on your account. Its configuration lives on the server, so you can change the appearance later without touching the page it sits on. The embed code contains only the widget's public id. It never contains an API key, an account id or your calendar data.

<iframe
  src="https://calcadian.com/embed/widget/wgt_example"
  width="100%" height="520" style="border:0"
  title="Delivery date calculator"></iframe>

White-label and appearance

  • Theme: light, dark or follow the visitor's system setting.
  • Colours: accent, and optionally background and text.
  • Layout: corner radius, border on or off, font scale, comfortable or compact density.
  • White-label removes the Calcadian credit. It is included on the paid plans.

Colour combinations below a 4.5:1 text contrast ratio are rejected when you save. That is not a style preference, it is the point at which body text stops being readable for a lot of people.

Logos

Paid plans can add a logo. It must be an https PNG, WebP or JPG, at most 100 KB and 600 by 200 pixels, and it needs alt text so screen readers can describe it. SVG is not accepted because it can carry script.

Licensed domains

A licensed domain is the site you are allowed to embed a saved widget on. Add the root domain and its subdomains are covered, so example.com also covers www.example.com and blog.example.com. Lookalike domains such as evil-example.com never match. Removing a domain frees the slot straight away.

Business Calendar widgets

A business-days widget can use one of your saved Business Calendars. The calendar is resolved on the server, so holidays, country, subdivision and custom dates are never exposed in the page. If the calendar is archived, or the plan no longer includes calendars, the widget reports a configuration problem instead of using different rules.

Sizing

A plain iframe with the recommended height works. The widget also posts its measured height outward as a calcadian:widget message, version 1, so an optional helper script on your page can resize it. The widget never accepts instructions from the page around it.

Analytics

Loads, calculations and errors per widget. Business adds breakdowns by domain and by calculator. Calcadian stores the widget, the event type, the registrable host and the timestamp. It does not store the dates a visitor entered, the results they saw, or anything identifying them.

Limits

  • Pro: up to 20 saved widgets on 3 licensed domains.
  • Business: up to 500 saved widgets on 25 licensed domains, plus the central widget manager.

Troubleshooting

  • Widget shows a configuration problem: open its diagnostics view. It shows status, white-label entitlement, licensed domains, calendar state, last render and the most recent error code.
  • Calcadian branding came back: white-label needs an active paid plan. After a downgrade, widgets revert to branded rather than breaking.
  • Widget refuses to load on your site: the host is probably not licensed. Add the root domain in the widgets section of your dashboard.
  • Height looks wrong: set the recommended height for that calculator, or add the resize helper.