frostdates.com

Turbo charge your gardening, homesteading and horticultural powers with our international frost date and growing zone calculator

Frost Dates Widget

Add international frost date lookups to your website in under a minute. Covers locations worldwide. Free to use — no account required.

See It in Action

The widget is live on VegPlotter, where gardeners use it to look up frost dates and growing zones for locations around the world. Take a look to see how it works on a real site.

View Live Demo

1. Add the Script

Drop a single <script> tag into your page. No build tools required.

2. Register Your Site

3. Done

Your visitors can now look up frost dates, growing zones, and more right on your site.

Free vs Paid Plans

Feature	Free	Paid (with API subscription)
Lookups per visitor	2 per day	Unlimited (per your plan quota)
Location search typeahead
Frost dates & USDA zones
Frost risk timeline
Dark & light themes
"Powered by frostdates.com" branding	Shown	Hidden
Your API key protected server-side	—

Quick Start

Add the widget to any HTML page with two lines of code:

1. Include the script

HTML

<script src="https://cdn.frostdates.com/widget/v1/frostdates-widget.iife.js"></script>

2. Add the widget element

HTML

<frostdates-widget site-id="YOUR_SITE_ID"></frostdates-widget>

Complete example

HTML

<!DOCTYPE html>
<html>
<head>
  <title>My Garden Site</title>
</head>
<body>
  <h1>Find Your Frost Dates</h1>

  <!-- Frost Dates Widget -->
  <frostdates-widget site-id="YOUR_SITE_ID"></frostdates-widget>

  <script src="https://cdn.frostdates.com/widget/v1/frostdates-widget.iife.js"></script>
</body>
</html>

Configuration

Configure the widget using HTML attributes:

Attribute	Required	Default	Description
`site-id`	Yes	—	Your registered site ID (get one from the dashboard)
`theme`	No	`light`	`light` or `dark`
`branding`	No	`true`	Show "Powered by frostdates.com" link (paid plans can set to `false`)

Dark theme example

HTML

<frostdates-widget site-id="YOUR_SITE_ID" theme="dark"></frostdates-widget>

JavaScript API

You can also create widgets programmatically:

JavaScript

// Create a widget and append it to a container
FrostDatesWidget.init({
  siteId: 'YOUR_SITE_ID',
  container: '#my-container',  // CSS selector or DOM element
  theme: 'light',              // optional
});

How Your API Key Stays Safe

If you have a paid API subscription, the widget uses a site registration model to keep your API key secure:

You register your domain in your developer dashboard and link it to your API key.
The widget only sends your public site ID (safe to embed in HTML).
Our server validates that the request comes from your registered domain, then uses your API key server-side.
Your API key never appears in the browser, page source, or network requests.

WordPress

A WordPress plugin is coming soon. In the meantime, you can add the widget to any WordPress site using a Custom HTML block:

Edit your page or post in WordPress.
Add a Custom HTML block.
Paste the two lines from the Quick Start section.
Publish or update the page.

Open Source

The widget is open source under the MIT licence. You can inspect the code, report issues, or contribute on GitHub:

frostdates/frostdates-widget

Get Your Site ID API Documentation

Free to use. No credit card needed for the free plan.

Provided by Veg Plotter Ltd, creators of the best and easiest to use garden planner