Section 1
Large Card (280 × 86 px)
The default size. Best for sidebars, status pages, and footers.
google.com — Dark theme large / dark
<iframe src="https://www.isitdowntoday.com/widget?site=google.com&size=large&theme=dark"
  width="280" height="86" frameborder="0" scrolling="no"></iframe>
google.com — Light theme large / light
<iframe src="https://www.isitdowntoday.com/widget?site=google.com&size=large&theme=light"
  width="280" height="86" frameborder="0" scrolling="no"></iframe>
github.com — Dark theme large / dark
<iframe src="https://www.isitdowntoday.com/widget?site=github.com&size=large&theme=dark"
  width="280" height="86" frameborder="0" scrolling="no"></iframe>
youtube.com — Dark theme large / dark
<iframe src="https://www.isitdowntoday.com/widget?site=youtube.com&size=large&theme=dark"
  width="280" height="86" frameborder="0" scrolling="no"></iframe>

Section 2
Small Badge (200 × 40 px)
Compact version — ideal for README files, inline text, or tight layouts.
google.com — Dark small / dark
<iframe src="https://www.isitdowntoday.com/widget?site=google.com&size=small&theme=dark"
  width="200" height="40" frameborder="0" scrolling="no"></iframe>
google.com — Light small / light
<iframe src="https://www.isitdowntoday.com/widget?site=google.com&size=small&theme=light"
  width="200" height="40" frameborder="0" scrolling="no"></iframe>
github.com — Dark small / dark
<iframe src="https://www.isitdowntoday.com/widget?site=github.com&size=small&theme=dark"
  width="200" height="40" frameborder="0" scrolling="no"></iframe>

Section 3
Script Tag Embed
The JS method — drops a <script> tag anywhere in your HTML and it auto-injects the iframe.
google.com — injected via widget.js large / dark
<script src="https://www.isitdowntoday.com/widget.js?site=google.com&size=large&theme=dark"></script>

Section 4
Inline Usage in Paragraph Text
Small badges can sit inline within a sentence — useful for blog posts or documentation.

Our infrastructure depends on several third-party services. Here is their current status: Google and GitHub — all statuses update automatically every 5 minutes.


Section 5
Real-World Site Mockup
How the widget looks embedded in a typical website sidebar and footer.
Home Products Blog Status

Welcome to AcmeCorp

We build reliable software for teams of all sizes. Our platform is built on top of proven infrastructure partners so you can focus on your work, not our uptime.

Check our live status dashboard any time. We monitor all our critical dependencies in real time.

Service Status

Section 6
Edge Cases
Unlisted domain (not in DB), empty site param, long domain name.
Unlisted domain not in DB
No site param empty
Long domain name overflow test

Section 7
URL Parameter Reference
All supported query parameters for /widget and /widget.js.
Parameter Values Default Description
site Any domain (e.g. google.com) Domain to show status for
size large · small large Widget dimensions (280×86 or 200×40)
theme dark · light dark Colour scheme
Section 8
Links Check
Verify all related routes are reachable.
RouteExpectedLink
/widget?site=google.com Badge iframe renders Open ↗
/widget?size=small&theme=light Small light badge Open ↗
/widget-generator Generator landing page Open ↗
/widget.js?site=google.com JS script returns Open ↗
/status/google Status page with sidebar widget Open ↗