Skip to main content

Custom Widgets

Custom in-app widgets - what they are, and how to use them.

Breakthrough Team avatar
Written by Breakthrough Team
Updated over 3 weeks ago

Custom Widgets

Custom widgets give you more control over how your app looks and feels. You can add up to five widgets per screen across your Home, Explore, and Community pages, giving you a total of 15 customizable spots to guide users toward your most important content or actions.

Widgets are a powerful way to:

  • Highlight seasonal challenges or new programs

  • Promote priority content such as routines, courses, or featured meditations

  • Link out to external pages like surveys, websites, or your merch store

What’s New in Version 6.6 and Above

Widgets are now easier to design and more consistent with your brand.

  • A new default color mode automatically pulls from your app’s theme, so your widgets match your overall design without extra effort

  • Image widgets now support optional overlay text

    • Add a short message, announcement, or label

    • Choose whether text appears at the top or bottom

    • Styled to match the look of Daily Class and Featured Content for a polished, consistent appearance

Why this matters: These updates save you time and help you create clean, on-brand visuals without needing to design each widget manually.

Widget Types

  • Text Widgets: Add a title, button, and background color

  • Image Widgets: Use tappable square or rectangular images that now support overlay text

How to Set Them Up

  1. In your Partner Portal, go to App Settings > Custom Widgets > Create Widget

2. Edit your custom widget, and save your work
​

3. Navigate to App Settings > Home/Explore/Community (depending on where you want the widget to go, then Add Custom Widget
​
​

4. Add the widget you created on the "Custom Widgets" screen

5. If you'd like text above the widget in app, edit the widget title here. You can also drag and drop to adjust the widget order on the home screen (be sure to save changes).


Here's what it looks like in-app:
​

Custom widgets give you flexibility to shape the user experience and highlight the content that matters most. With the new design updates in version 6.6 and above, they are faster to set up, more visually consistent, and better aligned with your brand.

Did this answer your question?