Documentation

Get going in
five minutes.

A calm, opinionated guide to scheduling with Tydl. Six short sections — read top to bottom or jump to what you need.

01 · Getting started

From zero to your first booking

Sign up with your email at /signup. You'll be taken through a three-step onboarding: profile, booking link, and timezone. The whole thing takes about two minutes.

Once you're in the dashboard, do these three things in order: set your availability (Mon–Fri 9–5 by default), create your first event type, and verify your email so bookings can go live.

02 · Availability

Tell Tydl when you're free

Open Dashboard → Availability. By default Monday through Friday are enabled, 9:00 to 17:00. Click any day pill to toggle it on or off. Add multiple windows per day if your schedule has gaps (lunch breaks, split shifts).

Times are in your local timezone, set during onboarding. You can change it later in Dashboard → Settings → Timezone. Internally everything is stored in UTC and converted only for display — DST transitions are handled correctly.

Buffer time and minimum notice are configured per event type, not globally. So a quick 15-min intro can have no buffer, while a 60-min consult can require 24 hours notice and a 15-min buffer.

03 · Event types

Create scheduling links people actually use

Open Dashboard → Event Types and click "New event type". Each event type is a separate booking page with its own URL, duration, location (Google Meet, Zoom, in-person, phone, custom), and rules.

The slug is the URL fragment. tydl.app/yourname/30-min-chat is what guests will see — keep it short and descriptive. Lowercase letters, digits, and hyphens only.

Set a duration (5–480 minutes), a buffer before and after, a minimum notice in hours, and a booking window in days. The booking window controls how far in advance guests can book.

Optional: cap bookings per day with the Max Bookings setting. The slot generator will exclude fully-booked days automatically.

04 · Embeds

Drop booking into any site

Embed your booking page anywhere with one line of script. Add this to your site's HTML:

<script src="https://tydl.app/embed.js" data-username="yourname" data-event="30-min-chat" async></script>

The widget renders inline, sized to fit the container. Pass data-theme="dark" to match a dark site, or omit it to follow the visitor's system preference.

Embeds use the same booking flow as your public page — slot locking, timezone conversion, email confirmation, all of it. Nothing degrades.

05 · Calendar sync

Connect Google Calendar

Dashboard → Settings → Calendars → Connect next to Google Calendar. You'll be redirected to Google to grant read/write permissions to your primary calendar.

Once connected, Tydl reads existing events from your calendar to detect conflicts before showing slots. Confirmed bookings are written back as events with the attendee, the meeting link, and your event type as the title.

Outlook and Apple Calendar are on the roadmap but not available yet.

06 · Cancellation & reschedule

How attendees manage bookings

Every confirmation email includes two one-click links: cancel and reschedule. Attendees never need to log in.

Cancellations are immediate. Both you and the attendee receive a notification, and the slot becomes available again.

Reschedules open the booking page back up with the original event type pre-selected. The attendee picks a new time; the old booking is cancelled atomically and the new one is created. Maximum three reschedules per booking — after that, attendees need to start fresh.

Need help?

We're a message away.

These docs cover the basics. If you're running into something specific, or want a feature considered, the contact page goes straight to a human.