WorldClock.lol

Developer Documentation

Embed world clocks, timezone tools, and meeting planners on your website. Free, customizable, and developer-friendly.

Quick Start

Add a world clock widget to your website in seconds:

HTML
<!-- WorldClock.lol Widget -->
<iframe
  src="https://www.worldclock.lol/?embed=true&cities=new-york,london,tokyo"
  width="100%"
  height="400"
  frameborder="0"
  title="World Clock Widget"
></iframe>

Embeddable Widget

Our embeddable widget displays multiple world clocks in a clean, responsive interface. Perfect for remote team dashboards, travel websites, and event pages.

Widget Features

  • Real-time clock updates every second
  • Visual working hours indicator (color-coded)
  • Automatic DST handling
  • Light and dark theme support
  • Mobile-responsive design
  • 1800+ cities supported

Customized Example

HTML
<!-- Customized WorldClock Widget -->
<iframe
  src="https://www.worldclock.lol/?embed=true&cities=san-francisco,berlin,singapore,sydney&theme=dark"
  width="100%"
  height="500"
  frameborder="0"
  style="border-radius: 12px; box-shadow: 0 4px 12px rgba(0,0,0,0.1);"
  title="Team World Clock"
></iframe>

Widget Dimensions

CitiesRecommended Height
1-2 cities200-300px
3-4 cities350-450px
5+ cities500px+

Use Cases

👥

Remote Team Dashboards

Display team member locations with working hours indicators. See at a glance who's available for meetings.

✈️

Travel Websites

Show destination times for trip planning pages. Help travelers understand time differences.

🎮

Gaming & Esports

Display event times across regions. Coordinate global tournament schedules.

📅

Event Pages

Show event times in attendee timezones. Reduce confusion for virtual conferences.

Developer FAQ

Is the widget free to use?

Yes! The embeddable widget is completely free for personal and commercial use. No API keys required.

Are there usage limits?

There are no strict limits for normal usage. The widget is served from our CDN and is designed to handle high traffic.

Can I customize the styling?

You can customize the iframe container styling (border, shadow, border-radius). The widget supports light/dark themes via the theme parameter.

Does it work with Content Security Policy?

Yes. Add https://www.worldclock.lol to your frame-srcdirective to allow the embed.

Is there a REST API?

We're planning a REST API for programmatic time data access. Join our mailing list for updates when it launches.

Ready to Get Started?

Try the world clock and copy the embed code for your site.