Portal: Setup & Customization > App Settings
Your App Settings are where you shape the foundation of your app — how it looks, how new users are welcomed, what features are labeled, and what your app can and can't do. This article gives you a quick tour of each tab so you know where to go when you want to update something.
You'll find these settings in the portal at Setup & Customization > App Settings.
🆕 = new in version 6.9
Theme
Controls the visual identity of your app:
App Font Family — one font for the whole app, picked from our supported list
Theme Colors (Light) and (Dark) — your Primary, Background, Card Background, Text, Sub Text, Outline, and Text On Primary colors. The color picker supports HEX and HSL; opacity isn't an option, so pick solid colors.
Tab Configuration — which tabs appear in the bottom navigation, their order, their labels, and their icons. Toggle a tab on or off, expand it to rename it or change its icon, and drag to reorder.
Onboarding
Controls what new users experience when they first open your app:
Landing Page Configuration — the carousel of intro screens shown after download. Each slide has a title, subtitle, and image. You'll also set the labels for the "Next" and "Get Started" buttons here.
Intro Video — an optional welcome video that plays after sign-in. We recommend keeping it under 60 seconds and in portrait (vertical) format.
User Onboarding Questions — the questions new users answer during sign-up. Keep it to a maximum of 5 to avoid overwhelming them. The tags you attach to each answer feed your Recommendation Widget 🆕 on the home screen, so each answer determines what content gets surfaced to that user.
General
The biggest tab — it controls behavior and copy for most major features. A quick map of what lives here:
Authentication — logo and button labels on your login/register screens
Default Values — default user avatar and admin post notification suffix
Reminder Settings — daily reminder copy and toggle title
Free Category — toggle on to surface a free content collection
Share — the message users send when sharing your app
Deeplink — including whether to always redirect to the store and whether web paywall is deeplink-only
Class Complete — continue button label and confetti animation
Notification Permission Prompt — title and subtitle for the permission ask
Achievement Success Dialog — celebration text and confetti animation
My Library "Create" sections — Playlist, My Meal Plan, My Routine, My Collection 🆕, My Challenges. Each has its own title, description, and (in most cases) image.
Exercise Log, Calendar Schedule, Apple/Google Health Sync, Offline Preview 🆕, Force Update Required, Monetization / Content Display 🆕 — feature-level controls and supporting copy
Most sections have a master toggle in the header that turns the whole feature on or off.
Media
Controls the labels used for every content type in your app — Class, Course, Program, Recipe, Routine, Playlist, and more. For each content type you'll typically set:
Plural Text (e.g., "Classes")
Singular Text (e.g., "Class")
A few sections add extras:
Course has button labels for Start, Next Session, and Restart
Recipe has a "Log Meal" button label
Routine includes an Exercise Timer End Beep toggle
Props Needed is the only section here with a master on/off toggle and lets you customize the props/equipment label
Use this tab to align content-type names with your brand voice.
Blacklisted URLs
A simple URL blocklist. Use + Add URL to add an entry, and the trash icon to remove one. Use this when you want to prevent specific links from being surfaced inside your app.
A few good practices
Save each section as you go. Edits don't carry across sections — if you've changed multiple sections, save each one before navigating away.
Preview before launching. Theme and Onboarding are highly visible to your users — review changes in a test build before rolling out.
Don't skip onboarding tags. They power the Recommendation Widget on the home screen, so untagged answers mean unpersonalized recommendations.
If you can't find a setting you need, or something isn't behaving as expected, reach out to your Breakthrough team — we're happy to help.