Get started with Workflow Analyzer

Learn how to use Workflow Analyzer to manually test your mobile applications.

Using Workflow Analyzer, you can perform targeted scans as you navigate through your app to ensure your mobile applications are accessible to all users. The analyzer uses BrowserStack’s proprietary rule engine to identify and document WCAG accessibility violations, such as missing labels, improper touch target sizes, inadequate text magnification, and more.

With BrowserStack, you can scan apps on a wide range of real Android and iOS devices with no setup required. The following information explains how to upload your app, run accessibility tests, and view reports.

Prerequisites

• Ensure you have a BrowserStack account. If you have not yet created an account, sign up for a free trial.

Run Workflow Analyzer

To analyze an app using Workflow Analyzer:

1. From the Workflow Analyzer dashboard, select a Device and OS combination.
   

2. Choose one of the following sources to install the app on the device:
   • Upload the app from your computer or by providing a direct URL
   • Install using Apple TestFlight
   • Download from the Apple App Store
   • Download from the Google Play Store
     
3. Optional: Customize the scan by configuring the following settings.
   • WCAG Conformance Level:
     1. Click the settings icon (see annotation 1).
     2. Choose the desired WCAG level (2.1 A, 2.1 AA, 2.1 AAA) from the dropdown menu.
     3. Enable the Include Best Practices toggle to add additional checks for best practices
   • Change the test location using GPS-based and IP-based geolocation changes (see annotation 2). Learn more about location testing.
   • Enable Local Testing to retrieve data from your pre-production environment (see annotation 3). Learn more about Local Testing.
     
4. Click Start scanning (see annotation 4) to begin analyzing the current app page.
   The analyzer will detect and highlight any accessibility violations on the right side of the screen.
5. Navigate through the app pages that you want to scan and click Scan viewport to scan pages as necessary.
6. To save a report without stopping the scan or device:
   1. Click the Save report button in the top right corner.
      
   2. In the Save report prompt, enter a name in the Report name field and click Save report and continue testing.
      
   3. Click Continue testing to keep scanning the app.
7. To stop the scan and the device:
   1. Click the Stop button in the top right corner.
      
   2. In the Save report before stopping session prompt, enter a name in the Report name field and click Save report.
      
   3. Alternatively, to discard the report, click Stop without saving.
      The session ends, the device stops, and you are directed to the Workflow Analyzer dashboard.

View scan reports

The scan reports provide detailed information about the accessibility issues detected during a scan, complete with annotated screenshots for easy identification of the affected elements and labels.

To view Workflow Analyzer reports:

1. On the App Accessibility dashboard, click Manual test reports in the left navigation.
   
2. Search for a report using one of the following methods:
   • Use the search field (see annotation 1) to find a report by name, app name, device, or users.
     
   • Use the Filter button (see annotation 2) to filter the report list by various options, such as creation date, User, Device, App, and OS.
     
3. Click a report to open it.
   You can review information about accessibility issues such as the severity levels, the specific elements that raised the issue, and the affected labels.

Next Steps

• Manage App Accessibility reports