How to test a mental health app
Direct answer
Shipped untested, a mental health app makes a user who tries to cancel go through several steps and charges the next month while the request is pending, and shares a diagnosis without consent or signs up a child under 13 without parental consent, in the cancellation and onboarding flows. 7 tests are mandatory here, each tied to a risk in the map below. After the release smoke check, start the risk tests with end-to-end functional tests: a test user must sign up, give or refuse consent, book a session and cancel the subscription, with each choice showing in account settings afterwards.
7 mandatory testsfirst: end-to-end functional tests
What counts as a mental health app
A mental health app here means an iOS or Android app that delivers therapy, mood tracking or crisis support, collects health answers from consumers and may be used by minors. It counts when users log moods, journal, answer intake questionnaires or book sessions inside the app. An app where clinicians prescribe during video visits is out of scope, and so is the record system a therapy practice keeps its charts in.
Adjacent product types not covered here
- telemedicine app: A telemedicine app prescribes in live visits, so its risks include controlled-drug refills and appointment-slot load that a mood and therapy app does not carry.
- patient portal: A patient portal shows a provider's records under HIPAA access rules, while a mental health app often sits outside HIPAA and answers to consent and breach notice rules.
- wearable companion app: A wearable companion app collects heart rate and sleep from a paired band, so its risks sit in Bluetooth pairing and missed alerts rather than questionnaire answers and subscriptions.
Risk map
| Risk | Grade | Note | Evidence | |
|---|---|---|---|---|
| Money leaves or fails to arrive money-loss | money | primary | A user in a hard week tries to cancel the therapy subscription, the cancel path takes several steps, and the next month is charged while the request is still pending. | |
| Fine or enforcement by a regulator regulatory-penalty | legal | primary | A mood journal or therapy app outside HIPAA shares a user's diagnosis without consent and owes breach notices, or signs up a child under 13 without the parental consent its audience requires. | |
| Personal or sensitive data exposed data-breach | data | primary | The onboarding questionnaire that asks about depression, self-harm or drinking sends each answer as an event to an ad platform, which then targets the user by condition. | |
| App rejected or removed by a store store-rejection | distribution | secondary by design analysis | The store rejects the build because mood data feeds ad targeting, or the listing claims to treat anxiety while the health apps declaration says wellness tool. |
Mandatory tests (7)
Step 1: release smoke tests
Why:store-rejection
Done when: On the release build, a test user completes onboarding, logs a mood entry and opens a therapy session screen on the oldest supported phone.
Tool class: mobile automation. Who usually runs it: QA engineer.
Step 2: end-to-end functional tests
Why:money-lossregulatory-penalty
Done when: A test user signs up, gives or refuses consent, books a session and cancels the subscription, and each choice shows in the account settings afterwards.
Tool class: mobile automation. Who usually runs it: QA engineer.
Step 3: payment and money-flow testing
Why:money-loss
Done when: After a test user cancels in the app, the store or payment sandbox shows the subscription ended and no charge on the next renewal date.
Tool class: API client. Who usually runs it: QA engineer.
Step 4: compliance checks
Why:regulatory-penaltystore-rejection
Done when: A reviewer confirms the consent screen names every third party that receives health data, the age gate blocks under-age sign-up without parental consent, and the store health declarations match the build.
Tool class: test management. Who usually runs it: product manager.
Step 5: analytics and event tracking tests
Why:data-breachregulatory-penalty
Done when: A network capture of onboarding, mood logging and session booking shows no questionnaire answer, mood value or condition name sent to any advertising or analytics domain.
Tool class: proxy. Who usually runs it: QA engineer.
Step 6: security scanning
Why:data-breach
Done when: The scan report for the app and API lists no open high-severity finding on the release date, and no journal or chat text is stored unencrypted on the phone.
Tool class: SAST scanner. Who usually runs it: security specialist.
Step 7: penetration testing
Why:data-breach
Done when: A tester signed in as one user cannot read another user's journal, chat or intake answers by changing an ID in a request.
Tool class: proxy. Who usually runs it: security specialist.
Recommended and optional tests
device and browser compatibilityrecommended
Becomes mandatory when crash reports cluster on specific phone models or OS versions.
exploratory testingrecommended
Becomes mandatory when evidence links a missed crisis path in this kind of app to harm, or the app adds an automated chat that replies to users in distress.
accessibility testingrecommended
Becomes mandatory when the app is offered through an employer, insurer or public program that requires WCAG conformance.
data integrity and migration testingrecommended
Becomes mandatory when clinicians review mood history to adjust treatment.
offline and poor-network testingrecommended
Becomes mandatory when users report lost journal entries.
unit testsoptional
May help on the logic that decides which screens show crisis resources and which events go to analytics.
regression suiteoptional
May help once SDK updates and consent changes ship often and old tracking calls reappear.
usability testingoptional
May help find where users abandon onboarding or cannot find cancellation and crisis resources.
Not needed and why
Not needed while one team ships the app and its API together. Becomes recommended when an employer or insurer integration consumes the API.
Not needed while usage is spread across the day with no booking peaks. Becomes recommended when live group sessions or scheduled launches concentrate users.
Not needed while content ships in one language. Becomes recommended when a second language is added, since crisis numbers differ by country.
Order of work
First release
- release smoke tests: Complete onboarding, log a mood entry and open a therapy session screen on the oldest supported phone with the release build.
- end-to-end functional tests: Sign up a test user, give and refuse consent, book a session and cancel the subscription, then check each choice in account settings.
- payment and money-flow testing: Cancel a test subscription in the app and confirm the store or payment sandbox shows it ended with no charge on the next renewal date.
- compliance checks: Review the consent screen against every third party that receives health data, try an under-age sign-up without parental consent, and match the store health declarations to the build.
- analytics and event tracking tests: Capture network traffic across onboarding, mood logging and session booking and look for any questionnaire answer, mood value or condition name sent to an advertising or analytics domain.
- security scanning: Scan the app and API, clear every open high-severity finding, and check that no journal or chat text is stored unencrypted on the phone.
- penetration testing: Sign in as one user and try to read another user's journal, chat or intake answers by changing an ID in a request.
Ongoing cadence
- release smoke tests: Before each store submission.
- analytics and event tracking tests: When any analytics, attribution or ad SDK is added or updated.
- end-to-end functional tests: After each change to the consent screen, onboarding questionnaire or cancel path.
- payment and money-flow testing: When subscription plans or renewal terms change.
- compliance checks: When a new third party starts receiving health data or the store listing claims change.
Tools
Listed alphabetically inside each test type, filtered to the tests above and to the platforms of mental health app (ios, android). Not recommendations.
release smoke tests
- Firebase Test LabRuns app tests on hosted devices. iosandroidfreemium
- TestRailTest case and run management. webiosandroidapicommercial
- XrayTest management inside Jira. webiosandroidapicommercial
end-to-end functional tests
- AppiumCross-platform mobile UI automation over WebDriver. iosandroidopen-source
- ApplitoolsVisual comparison of screens across builds. webiosandroidcommercial
- BrowserStackCloud of real devices and browsers. webiosandroidcommercial
- DetoxGray-box end-to-end testing for React Native apps. iosandroidopen-source
- EspressoAndroid UI testing framework from Google. androidopen-source
- LambdaTestCloud browser and device grid. webiosandroidcommercial
- MaestroMobile UI flows written in YAML. iosandroidfreemium
- Sauce LabsCloud test infrastructure for web and mobile. webiosandroidcommercial
- XCTestApple's framework for unit and UI tests. iosopen-source
payment and money-flow testing
- Adyen test environmentTest cards and scenarios for Adyen integrations. webapiiosandroidcommercial
- Stripe test modeTest cards and scenarios for Stripe integrations. webapiiosandroidfreemium
analytics and event tracking tests
- AvoTracking plan and event validation. webiosandroidfreemium
- Segment ProtocolsTracking plan validation for Segment events. webiosandroidcommercial
security scanning
device and browser compatibility
- AppiumCross-platform mobile UI automation over WebDriver. iosandroidopen-source
- ApplitoolsVisual comparison of screens across builds. webiosandroidcommercial
- BrowserStackCloud of real devices and browsers. webiosandroidcommercial
- Firebase Test LabRuns app tests on hosted devices. iosandroidfreemium
- LambdaTestCloud browser and device grid. webiosandroidcommercial
- Sauce LabsCloud test infrastructure for web and mobile. webiosandroidcommercial
accessibility testing
- Accessibility ScannerGoogle's on-device accessibility checker for Android. androidopen-source
offline and poor-network testing
- Charles ProxyHTTP proxy for inspecting and throttling traffic. iosandroidwebcommercial
- mitmproxyInteractive HTTPS proxy. iosandroidwebapiopen-source
- Network Link ConditionerApple tool for simulating poor network conditions. iosopen-source
What to send to the person who will test
Send the checklist and the brief below. The printable checklist for mental health app has the same 7 items with checkboxes.
Download the checklistMarkdownCSVBrief (Markdown)
Acceptance criteria wording
A release of the mental health app is accepted when a cancellation in the app ends the subscription with no charge on the next renewal date and each consent choice shows in account settings. No questionnaire answer, mood value or condition name reaches an advertising or analytics domain, an under-age sign-up without parental consent is blocked, and no journal or chat text sits unencrypted on the phone.
Brief
# Test brief: mental health app Product type: mental health app. Therapy, mood tracking or crisis support delivered in an app. Risk map and evidence: https://howtotestaproduct.com/how-to-test/mental-health-app/ Printable checklist: https://howtotestaproduct.com/checklists/mental-health-app/ Run these 7 mandatory tests in this order. A test is done only when its done condition is true on the build you will release. 1. release smoke tests (risks: store-rejection). Tool class: mobile automation. Usually run by: QA engineer. Done when: On the release build, a test user completes onboarding, logs a mood entry and opens a therapy session screen on the oldest supported phone. 2. end-to-end functional tests (risks: money-loss, regulatory-penalty). Tool class: mobile automation. Usually run by: QA engineer. Done when: A test user signs up, gives or refuses consent, books a session and cancels the subscription, and each choice shows in the account settings afterwards. 3. payment and money-flow testing (risks: money-loss). Tool class: API client. Usually run by: QA engineer. Done when: After a test user cancels in the app, the store or payment sandbox shows the subscription ended and no charge on the next renewal date. 4. compliance checks (risks: regulatory-penalty, store-rejection). Tool class: test management. Usually run by: product manager. Done when: A reviewer confirms the consent screen names every third party that receives health data, the age gate blocks under-age sign-up without parental consent, and the store health declarations match the build. 5. analytics and event tracking tests (risks: data-breach, regulatory-penalty). Tool class: proxy. Usually run by: QA engineer. Done when: A network capture of onboarding, mood logging and session booking shows no questionnaire answer, mood value or condition name sent to any advertising or analytics domain. 6. security scanning (risks: data-breach). Tool class: SAST scanner. Usually run by: security specialist. Done when: The scan report for the app and API lists no open high-severity finding on the release date, and no journal or chat text is stored unencrypted on the phone. 7. penetration testing (risks: data-breach). Tool class: proxy. Usually run by: security specialist. Done when: A tester signed in as one user cannot read another user's journal, chat or intake answers by changing an ID in a request. Acceptance criteria wording: A release of the mental health app is accepted when a cancellation in the app ends the subscription with no charge on the next renewal date and each consent choice shows in account settings. No questionnaire answer, mood value or condition name reaches an advertising or analytics domain, an under-age sign-up without parental consent is blocked, and no journal or chat text sits unencrypted on the phone. Report back for each test: pass or fail against its done condition, the build or version tested, and the proof (screenshot, log line or report file). Licence: CC BY 4.0.
For founders: what to forward and what to ask back. For product managers: turning this page into tickets.
Questions about testing a mental health app
What testing does a mental health app need?
7 mandatory tests cover the 4 risks in the map: questionnaire answers sent to ad platforms, diagnoses shared without consent or children under 13 signed up without parental consent, multi-step cancel paths that still charge, and store rejection over health claims. They run as release smoke, end-to-end, payment sandbox, compliance, analytics tracking, security scanning and penetration tests. Exploratory testing of crisis paths is recommended until the app adds an automated chat that replies to users in distress.
What gets a mental health app rejected by an app store?
The risk map records rejection when mood data feeds ad targeting, or when the listing claims to treat anxiety while the health apps declaration says wellness tool. This risk is labelled by design analysis. The compliance check matches the store health declarations to the build, and the analytics tracking test confirms no mood value reaches an ad domain.
Which tests in a vendor test plan for a mental health app are not needed?
Contract, performance and localization tests are marked not needed: one team ships the app and its API together, usage has no booking peaks, and content ships in one language. Localization becomes recommended when a second language is added, since crisis numbers differ by country.
What does HIPAA mean for testing a mental health app?
The risk map covers an app outside HIPAA that still owes breach notices when it shares a diagnosis without consent, citing the FTC Health Breach Notification Rule. The compliance check confirms the consent screen names every third party that receives health data. The analytics tracking test confirms no condition name reaches an ad or analytics domain.
What should I send to the person who will test a mental health app?
Send the 7 mandatory tests with their done conditions, test accounts for an adult and an under-age user, and sandbox access for the subscription. Include the list of analytics and ad SDKs in the app and the list of third parties named on the consent screen.
Evidence
ev-0142regulatorprimary
Proposed FTC Order will Prohibit Telehealth Firm Cerebral from Using or Disclosing Sensitive Data for Advertising Purposes, and Require it to Pay [amount], U.S. Federal Trade Commission
The FTC complaint describes pharmacy and prescription information sent to third parties through tracking tools, a patient portal access method that exposed medications to other patients, a failure to block former employees from accessing medical records, and a cancel-anytime promise contradicted by a multi-step, often multi-day cancellation process during which consumers kept being charged. The first two transfer to pharmacy delivery apps; the cancellation finding transfers to any recurring subscription sold online.
published 2024-04-15 · verified 2026-10-07
ev-0024regulatorprimary
Children's Online Privacy Protection Rule (COPPA), U.S. Federal Trade Commission
COPPA requires verifiable parental consent before collecting personal information from children under 13 on sites and apps directed to children or with actual knowledge.
published undated · verified 2026-10-07
ev-0109regulatorprimary
FTC Gives Final Approval to Order Banning BetterHelp from Sharing Sensitive Health Data for Advertising, Requiring It to Pay [amount], Federal Trade Commission
Final FTC order against an online counseling service that sent email addresses, IP addresses and health questionnaire answers to ad platforms after promising privacy. Supports data-breach and regulatory-penalty for mental health apps whose intake questionnaire reveals the user's condition, and for telemedicine apps that run the same intake before a therapy visit.
published 2023-07-14 · verified 2026-10-07
ev-0111regulatorprimary
FTC Finalizes Changes to the Health Breach Notification Rule, Federal Trade Commission
FTC rule update stating that health apps outside HIPAA are covered and that an unauthorized disclosure of identifiable health information counts as a breach that must be notified. Supports regulatory-penalty and data-breach for mental health apps and fitness apps that sell direct to consumers, and wearable companion apps, since the FTC ties the update to health apps and connected devices.
published 2024-04-26 · verified 2026-10-07
ev-0170regulatorprimary
Alcohol Addiction Treatment Firm will be Banned from Disclosing Health Data for Advertising to Settle FTC Charges that It Shared Data Without Consent, Federal Trade Commission
Monument used the information to target ads for its services to both current users who subscribe to the lowest cost memberships and to target new consumers, according to the complaint.
Enforcement against an online alcohol use disorder treatment service whose pixels and APIs sent intake and treatment events to ad platforms without consent. Supports data-breach and regulatory-penalty for telemedicine apps and for mental health apps, which collect the same kind of intake answers.
published 2024-04-11 · verified 2026-10-07
ev-0001store-guidelineprimary
App Review Guidelines, Apple
Apple reviews every iOS, iPadOS and macOS App Store submission against these guidelines, including crashes and bugs at review, privacy disclosures, in-app purchase rules and extra rules for medical, financial and kids apps, and apps with user-generated content must let users report offensive content and block abusive users (guideline 1.2), and apps offering loot boxes or similar mechanisms must disclose the odds of each item type before purchase (guideline 3.1.1).
published undated · verified 2026-10-07
ev-0110store-guidelineprimary
Health Content and Services, Google Play
We don't allow apps with health and medical related functionalities that are misleading or potentially harmful.
Google Play policy for health apps: a health apps declaration is required, Health Connect data is personal and sensitive user data, apps regulated as medical devices must show clearance, and clinical service payments have their own rules. Applies to every health app distributed on Google Play, so it supports store-rejection for mental health, fitness and telemedicine apps and data-breach for fitness apps that read Health Connect.
published undated · verified 2026-10-07
Disclaimer
This page lists tests and risks for a product category, not for your product. Risks are attached only with the evidence shown in the Evidence section. Tools are listed alphabetically and are not recommendations. Nothing here is legal, regulatory or security advice; where a regulator or a store sets a requirement, their page is linked and takes precedence.