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 Habit Heroes with your email address.
Connect Your Notion
Link your Notion workspace. Notion copies our Habit Tracker template into it for you.
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 safety-net sync at your local midnight
Your habits sync live every time you open the widget. As a safety net, each connected user's habits also sync once at midnight in their own configured timezone, so a day you never opened the widget still gets closed. A user in Tokyo and a user in Berlin each get their safety-net 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.
If a sync ever fails
If a sync fails overnight, a self-healing check catches and re-runs it in the early morning, so a technical hiccup on our side never breaks your streak.
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.
Freeze 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. To compute streaks and points, Notion Habit Heroes also keeps a copy of your habit names and daily values on its own servers.
Disconnect anytime
Remove the Notion connection from your profile at any time. No lock-in.
Free to use
The habit tracker is completely free. 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 connecting Notion from this site copies it into your workspace for you. If you already have a daily-pages database with checkbox properties, choose Select pages during the connect and pick it instead.
- What happens if I miss checking habits one night?
- Missing one night does not cost you anything right away. You can still check off yesterday's habits any time today. It counts as soon as a sync runs that day: automatically when you open the Notion page with your widget, or on the spot with the Update button in the widget toolbar. Only from the day after is yesterday settled and no longer changeable. Freeze days protect a streak on a day you genuinely miss beyond that window.
- When do streaks update?
- Your streak count updates whenever a sync runs. A sync runs every time you open the Notion page with your widget, or on the spot when you click Update in the widget toolbar, so a check-off shows up in your streaks and points instantly. Independently, a nightly sync runs at midnight in your configured timezone to close the day even if you never opened the widget. A self-healing check also retries any sync that failed overnight, so by the time you start your day your streaks reflect the previous night.
- What happens if I disconnect Notion?
- Disconnecting takes back the permission you gave Notion Habit Heroes to read your habit database. You can do it at any time from your Profile page with Disconnect Notion. Syncing stops right away. Nothing in Notion is deleted, and your history, streaks, points and badges stay in your account. You stay in your competitions, but you don't earn new points while disconnected. To come back, connect again and choose the same database: your data is still there. Days in between are not filled in later, because a sync only reads today and yesterday, so a gap of more than one day resets your streaks. Choosing a different database starts your history fresh. To remove your data instead, use Delete Account on your Profile page.
- 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, letting the connect step copy the free template is the fastest starting point.
Ready to Build Better Habits?
Built and run solo since February 2023. Every habit synced live when you open the widget, with a nightly safety net in your own timezone.