> ## Documentation Index > Fetch the complete documentation index at: https://docs.habitify.me/llms.txt > Use this file to discover all available pages before exploring further. # Widget Habitify's widgets give you a quick yet complete view of your habit progress directly from your **home screen**, therefore, no need to open the app just to check where you stand. Widgets of Habitify aims to give a quick yet still complete view of habit progress directly on the home screen and the lock screen. This article gives you a tour through all the available widgets of Habitify. ## Widget types ## Homescreen Widgets ### **Progress Chains**

The Progress Chains widget show the habit list with each habit's progress reprented with a heatmap. There are options of date range: *Last 7 Days*, *Last 14 Days*, *Last 21 Days*, *Last 30 Days*, *This Week*, and *This Month*. For the list to show, you can choose between All Habits, Current Time of Day, or a custom area. The widget is available in 3 sizes: * Small size shows 3 habits at most. * Medium size shows 3 habits at most. * Large size shows 8 habits at most. ### Current Streak

This widget is designed for pure motivation. It displays the current streak number for any single good habit you choose. Seeing your streak grow right on your home screen is a powerful reminder of your commitment. The widget is available in Small size only. ### Consistency Grid

The Consistency Grid widget is designed to show the progress's heatmap of a good habit. This widget is available in 2 sizes: * The Small-sized widget shows progress of the last 96 days * The Medium-sized widget shows progress of the last 216 days ### **Today's Habits**

The Today widget will show the list of good habits that are set to repeat on the current day, in a compact layout. You can configure this widget to show All Habits, habits in the Current Time off Day, or habits of a custom area. Next to each habit is its current streak. On this widget, your habits are organized following the custom order of habits that you've set in Settings → All Habits. The widget is available in 3 sizes: * Small size shows 3 habits at most. * Medium size shows 3 habits at most. * Large size shows 8 habits at most. ### Tap to Track

The Tap to Track widget allows you to update the status of your habit right on the home screen. There are 2 buttons designed on this widget, which you have the ability to configure as the button to mark as Completed, Skipped, or Failed, or the button to start a Timer session. The widget is available in Small size only. ### Days Since

The Days Since widget helps you to track a single bad habit with to goal to quit right on your home screen. There is no button to check-in or log progress on this widget, since we do not encourage this action, of course. On this widget, you can see the current streak you've accomplished in staying away from the bad habit. The widget is available in Small size only. ### Goal Progress

The Goal Progress widget will show you a progress bar of your good habit which has a goal set per week, month, or year. The widget is available in Small size only. ### Limit Tracker The Limit Tracker widget represents the progress bar of your bad habit with the goal to limit. In the middle of the progress bar, you can see a red vertical line. It marks the limitation you should not go over. Once you go over, the surpassed value will be represent in red. The widget is available in Small size only.

## Lockscreen widgets Since iOS 16, Apple has supported widgets directly on the Lock Screen, and Habitify offers a set of widgets (Today's Habits, Consistency Grid, and Tap to Track), designed specifically for that space, so you can see your habit progress before even unlocking your phone. **How to add a Lockscreen Widget:** 1. Touch and hold your Lock Screen until the **Customize** button appears. 2. Tap **Customize**. 3. Select **Lock Screen**. 4. Tap the widget area on your Lock Screen to open the widget gallery. 5. Find **Habitify** in the list, and choose the widget you want to add. 6. Tap outside the customization screen to save your changes.

## Check in with widgets When you tap a habit on the widget, consequently, **the app will open to Journal view and highlight your habit.** It means to help you navigate to your habit through the list and check in your progress easier. Especially, for the **Tap to Track** widget: * When you tap on the button to Complete, Skip, or Fail, your check in will be processed and saved right in your homescreen. * When you tap on the Timer, the app will open and lead you to the Timer right away. ## Resizing Widgets: Ability and Limitations Apple's iOS has a stricter design for its home screen. You cannot freely resize widgets by dragging their corners. Instead, your ability to "resize" is limited to choosing from the predefined, standard sizes. ### **How to Resize** If you using the kinds of widgets that are available in multiple size, you can freely switch among different sizes with these simple steps: 1. Long-press on the widget 2. If the size is available, you can choose it from the dragged context menu. ### **Limitation** For other widgets which are designed in one size only, you can resize it into the app icon. However, you cannot resize it back later but re-add it again from the widget gallery. ## FAQs First of all, ensure that you have the latest version of Habitify installed on your device. To check for updates: * Open the **App Store**. * Tap on your profile icon at the top right corner. * Scroll down to see if Habitify has an available update. * If an update is available, tap **Update**. Secondly, Ensure that no restrictions are preventing the widget from appearing: * Open **Settings**. * Go to **Screen Time** → **Content & Privacy Restrictions**. * Make sure that widgets are allowed. Sometimes, a simple restart can resolve the issue: * Press and hold the power button until the slider appears. * Slide to power off. * After the device turns off, press and hold the power button again until you see the Apple logo. If the widget still does not appear, try reinstalling the app: * Long-press on the Habitify app icon and select **Remove App**. * Go to the **App Store** and reinstall Habitify. Here are the main reasons for delays: * **Aggressive Battery Optimization:** This is the #1 reason. To give you all-day battery life, your phone's operating system (both iOS and Android) actively limits how often background processes, like widgets, can "wake up" to ask for new data. It may decide to delay an update by several minutes or longer. * **Widgets are Separate Processes:** A widget is a mini-app on your home screen. It needs to communicate with the main Habitify app to get the latest information. If the main app has been forced to sleep by the OS (especially common on Android), the widget can't get new data and will display the last information it had. Before diving into device-specific settings, try these simple steps that resolve most common widget issues on any platform. 1. **Open the Habitify App:** The simplest first step is to open the main Habitify app and leave it in the foreground for 30-60 seconds. This often forces the widget to sync the latest data. 2. **Remove and Re-add the Widget:** If that doesn't work, try removing the widget from your home screen and adding it back again. This forces the widget to completely reload its configuration. 3. **Restart Your Device:** A full restart of your phone is a classic for a reason—it can clear out temporary system glitches that may be affecting the widgets. iOS widgets are updated on a schedule managed by the system. If the cache is stale, you can force a refresh. * **Edit the Widget:** Long-press the Habitify widget and tap **"Edit Widget."** Try toggling the data source (e.g., switch from "All Habits" to an "Area," then switch back) or re-select the specific habit from the list. This action often forces the widget's data to reload. * **Enable Background App Refresh:** Ensure iOS can update the widget in the background. Go to your iPhone's **Settings → General → Background App Refresh** and make sure the setting is on and the toggle for Habitify is enabled. Bad Habits are not supported to apear in Today's Habits widget and Progress Chains widget. The main reason for this design is to keep your daily to-do list focused and motivating. 1. **Your "Today's List" is for Taking Action.** This widget is designed to be your daily checklist, reminding you of the positive actions you need to **take**. Including a bad habit like "Don't Smoke" on a list of things *to do* can be counter-productive. The goal is to avoid and forget about the bad habit, not be reminded of it alongside your positive tasks. 2. **The "Progress Chain" is for Celebrating Success.** This widget's purpose is to create a satisfying, visual chain of your accomplishments. For bad habits, success is achieved through *inaction* or *avoidance*. If we included bad habits here, the widget would just show a series of blank or failed ("X") blocks, which isn't very motivating to see on your home screen every day. By keeping these widgets focused on your good habits, we aim to create a more positive and action-oriented dashboard for your day. This is not a bug — it's an iOS privacy feature. By default, iOS hides all widget content when your phone is locked to protect sensitive information from being seen without authentication. If you'd like your Habitify habits to stay visible on the lock screen at all times, you can change this setting. Follow these steps: 1. Open your iPhone **Settings** 2. Scroll down and tap **Face ID & Passcode** (or **Touch ID & Passcode**, depending on your iPhone model) 3. Enter your screen passcode 4. Scroll down to the **Allow Access When Locked** section 5. Toggle **ON** the option for **Lock Screen Widgets** (on older iOS versions, this may be labeled **Today View and Search**)
## Homescreen widgets ### **Consistancy Grid** The Consistancy Grid widget is designed to represent the heatmap of a good habit's progress. How much history it shows depends on the size you set it to on your home screen.

### **Days Since** The Days Since widget helps you to track a single bad habit with to goal to quit right on your home screen. There is no button to check-in or log progress on this widget, since we do not encourage this action, of course. On this widget, you can see the current streak you've accomplished in staying away from the bad habit.

### **Goal Tracker** The Goal Tracker widget is designed to help you track a habit with goal per week, per month, or per year, whether it is a good habit or a bad habit (to limit). * For a good habit, it shows a progress bar of achieving the goal.

* For a bad habit to limit, it shows a progress bar against the limitation, with a red verticaline in the middle, marking the limitation you should not go over. Once you go over, the surpassed value will be represent in red.

### Current Streak This widget is designed for pure motivation. It displays the current streak number for any single habit you choose.

### Today's Habits The Today widget will show the list of good habits that are set to repeat on the current day, with a compact layout. You can configure this widget to show all habits or the habit list of an area. Next to each habit is its current streak. On this widget, your habits are organized following how you sort them on the in-app Journal screen. When a habit is completed: * its streak is updated * it will come down to the bottom of the list, prioritizing the incomplete ones.

## Check in with widgets When you tap a habit on the widget, consequently, the app will open to Journal view and pull the view down to the habit. It means to help you navigate to your habit through the list and check in your progress easier. ## **Resizing Widgets: Ability and Limitations** Android's operating system is designed to be highly flexible, allowing users to freely resize most widgets after they have been placed. ### **How to resize** 1. Place a Habitify widget on your home screen. 2. **Long-press** on the widget until resize handles (dots or lines on the edges) appear. 3. **Drag the handles** to expand or shrink the widget to your desired size. 4. The widget's content will automatically adjust to fit the new dimensions. ### **Limitation** The main limitation on Android can be your specific device's launcher. Some manufacturers may have slight variations in how resizing is handled. ## FAQs Before diving into device-specific settings, try these simple steps that resolve most common widget issues on any platform. 1. **Open the Habitify App:** The simplest first step is to open the main Habitify app and leave it in the foreground for 30-60 seconds. This often forces the widget to sync the latest data. 2. **Remove and Re-add the Widget:** If that doesn't work, try removing the widget from your home screen and adding it back again. This forces the widget to completely reload its configuration. 3. **Restart Your Device:** A full restart of your phone is a classic for a reason—it can clear out temporary system glitches that may be affecting the widgets. Widget issues on Android are almost always caused by aggressive battery optimization settings that stop the app from running in the background. * **Set Battery to "Unrestricted":** This is the most important step. Go to your phone's **Settings → Apps → Habitify → Battery** and change the setting from "Optimized" to **"Unrestricted."** * **Lock the App in Recents (Especially for Xiaomi/OnePlus/Oppo):** Open your "Recent Apps" screen. Press and hold on the Habitify app's preview and tap the \*\*Lock icon. \*\*This tells your phone's system to prioritize Habitify and not shut it down automatically. * **Check Autostart Permissions:** In your phone's settings, find the "Autostart" or "Startup" manager and ensure Habitify is enabled. Bad habits are not supported to appear on Today's Habits widget. The main reason for this design is to keep your daily to-do list focused and motivating. 1. **Your "Today's List" is for Taking Action.** This widget is designed to be your daily checklist, reminding you of the positive actions you need to **take**. Including a bad habit like "Don't Smoke" on a list of things *to do* can be counter-productive. The goal is to avoid and forget about the bad habit, not be reminded of it alongside your positive tasks. 2. **The "Progress Chain" is for Celebrating Success.** This widget's purpose is to create a satisfying, visual chain of your accomplishments. For bad habits, success is achieved through *inaction* or *avoidance*. If we included bad habits here, the widget would just show a series of blank or failed ("X") blocks, which isn't very motivating to see on your home screen every day. By keeping these widgets focused on your good habits, we aim to create a more positive and action-oriented dashboard for your day. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.