Developers
Free holiday countdown and HTTP status widgets for your website
Pick a widget, set the options and paste the iframe snippet into any HTML page. The widgets are free, set no cookies, load nothing from third parties and weigh a few kilobytes, with a small link back to the data on arielton.com.
Build your widget
Preview
360 × 238 px. The widget stretches to the iframe width. Open the widget in a new tab
Embed code
<iframe src="https://www.arielton.com/embed/next-holiday?country=brazil" title="Next holiday in Brazil" width="360" height="238" loading="lazy" style="border:0;max-width:100%"></iframe>
<p style="margin:4px 0 0;font-size:13px"><a href="https://www.arielton.com/holidays/brazil">All holidays in Brazil</a> · arielton.com</p>The widgets
| Widget | What it shows | Options |
|---|---|---|
Next holiday/embed/next-holiday | The next national (or US federal) holiday, its date and a live countdown in the visitor's time zone. | country, locale, theme, transparent |
Holiday list/embed/holiday-list | Every holiday of one year, with past days dimmed and the next one highlighted. | country, year, optional, locale, theme, transparent |
HTTP status card/embed/http-status | One status code with its class, one-line meaning and a link to the RFC. | code, locale, theme, transparent |
Query parameters
| Name | Description |
|---|---|
country | brazil, united-states, portugal (or br, us, pt). Default brazil. |
year | 2026, 2027 or 2028. Default: the current year. |
optional | 1 to include optional days (pontos facultativos, Carnival in Portugal). |
code | Any code listed by the HTTP status API. Default 404. |
locale | en or pt. Default en. |
theme | light, dark or auto. Default light. |
transparent | 1 for a transparent background. |
Size, speed and privacy
- One HTML request of about 2 to 4 KB, cached by the CDN. No framework, no web fonts, no images.
- loading="lazy" in the snippet means the widget loads only when it scrolls into view.
- No cookies, no storage, no analytics, no third-party requests. The only script (countdown and list) reads the visitor's clock.
- The widget is sent with a strict Content-Security-Policy that allows exactly its own inline script, and noindex so it never competes with your page in search.
Frequently asked questions
- Are the widgets free?
- Yes, for any site, personal or commercial. There is no account and no key. The small arielton.com link inside the widget is the only thing asked in return.
- Do the widgets use cookies or track visitors?
- No. A widget is one HTML document with inline CSS and, for the countdown and list, a script under 1 KB that reads the visitor's clock. It sets no cookies and makes no other requests.
- How do I add the widget to WordPress?
- Paste the snippet into a Custom HTML block. Some hosted plans strip iframes from posts; if the widget disappears after saving, your plan or user role does not allow iframes.
- Does the countdown update by itself?
- Yes. The page picks the next holiday using the visitor's own date, so it is right in any time zone, and the time left ticks every second. Once a holiday passes, the next one takes its place without any change to your page.
- Can I change the colors?
- Use theme=light, theme=dark or theme=auto (follows the visitor's system setting), and transparent=1 to let your page background show through. The widget is on another origin, so your own CSS cannot reach inside it.
Last reviewed by Arielton Oberek.