How It Works
Just follow these four easy steps to enroll on your Habit Hero Journey. All you need to get started is a free Notion account. If you don't have one yet, create one on notion.com first. In the pre-built Habit Tracker Template that comes with our Notion integration you will get details on how to track your progress and compete with friends in our interactive widget.
Create a Free Account
Sign up for NotionHabitHeroes with your email address.
Connect Your Notion
Link your Notion workspace and duplicate our Habit Tracker template.
Get the free Notion habit template →Learn more about the templateEmbed Your Widget
Copy your personal widget URL and embed it directly in your Notion workspace.
Track & Compete
Check off your daily habits in Notion and watch your streaks grow. Join competitions to stay motivated!
How it actually works
The four steps above are all you need to get started. Here is what runs in the background once you are connected, and why the integration is built this way.
Nightly sync at your local midnight
Each connected user's habits sync once at midnight in their own configured timezone. A user in Tokyo and a user in Berlin each get their sync at their local midnight, not at a shared global time. Your streak count is always up to date by the time you wake up, wherever you live.
What happens when a sync is missed
A separate monitoring job runs every morning at 3 a.m. It checks every connected user's sync for their local date and reruns any that failed or were skipped overnight. A missed sync in this product is a broken streak, so the repair job is not optional infrastructure; it is core to how the product works and runs silently every day.
Why streaks need an API integration
Notion formulas can reference properties on a single database page, but they cannot count consecutive days across multiple pages. The streak count in your widget is computed server-side by reading your Notion database via the official API. That is the only reason an integration is required; the goal was never to pull your data elsewhere. Read more on the about page.
What You Get
Streak Tracking
Build momentum with daily habit streaks. Don't break the chain!
Competitions & Duels
Challenge friends in group competitions or one-on-one duels. The widget shows both via tabs so you always know where you stand.
On Pro PlanFreeze Days
Life happens. Use freeze days to protect your streaks when needed.
Progress Stats
Track your completion rates and see your improvement over time.
Your data stays in your Notion
Limited OAuth scope
The app reads one Notion database you choose. It cannot access the rest of your workspace.
Data in your workspace
Habit entries stay in your own Notion database. We sync points and streaks; your pages live on Notion's servers.
Disconnect anytime
Remove the Notion connection from your profile at any time. No lock-in.
Payments via Stripe
Card details never touch our servers. EU-based operator. See our privacy policy and imprint.
Common questions
- Which Notion setups work?
- You need a Notion database where each row represents one day and has at least one checkbox property per habit you want to track. The free Notion habit tracker template is set up exactly this way and takes under two minutes to duplicate. If you already have a daily-pages database with checkbox properties, you can connect it directly during setup without duplicating the template.
- What happens if I miss checking habits one night?
- Streaks are calculated from what you checked off in Notion by midnight in your timezone. If you miss checking habits on a given day, that day counts as a miss for streak purposes. Freeze days are available on all plans and let you protect a streak when life gets in the way without breaking your chain.
- When do streaks update?
- The nightly sync runs at midnight in your configured timezone. Your streak count in the widget updates after that sync, typically within seconds of midnight. The self-healing job at 3 a.m. also retries any sync that failed overnight, so by the time you start your day your streaks reflect the previous night.
- Can I disconnect my Notion workspace?
- Yes. You can remove the Notion connection at any time from your profile page. Your habit data stays in your own Notion workspace; nothing in Notion is deleted when you disconnect. If you later reconnect the same database, your streak history picks up where it left off. Connecting a different database starts fresh.
- Does it work with an existing habit database, or only the template?
- Both. During setup you can connect any existing Notion database that has daily pages with checkbox properties. See the template page for the exact schema the integration expects, so you can compare it against your own setup. For most users, duplicating the free template is the fastest starting point. See pricing for plan details.
Ready to Build Better Habits?
Built and run solo since February 2023. Every habit synced nightly in your own timezone.