Getting Started with ContextQA Test Automation: Training Session 1
A companion to ContextQA Training Session 1. It walks through what the platform does, how to navigate the dashboard, how to create and run a test in plain English, how to read results, and how runs connect to Jira.
What you will learn
- What ContextQA is and the problems it solves
- Where to find resources, the Chrome extension, and documentation
- How to navigate the dashboard and organize test cases
- How to create and run a test in plain English
- How to read execution results, video, screenshots, and visual regression
- How to link test runs and bugs to Jira
Session outline
- What ContextQA is and the problems it solves
- Resources: website, Chrome extension, and documentation
- The dashboard and organizing test cases
- Creating and running a test in plain English
- Reading results: video, screenshots, and visual regression
- Linking test runs and bugs to Jira
- Capturing manual testing that becomes automation
This guide is a written companion to ContextQA Training Session 1. The session introduces the platform, explains the testing problems it is built to solve, and then moves into a live walkthrough of the dashboard, creating and running a test, reading the results, and connecting everything to Jira.
If you are new to ContextQA, read this end to end. It follows the same order as the session, so you can pause the video at any point and find the matching steps here.
What ContextQA is and the problems it solves
ContextQA is a software test automation platform. It provides end-to-end testing for teams of any size and across different domains, whether you are an early stage startup, a growing company, or an enterprise. You can start automation from scratch on the platform, or migrate existing test cases onto it.
The session frames the problem first. Many quality issues trace back to the same root causes: not enough test automation, testing that is not continuous, limited test resources, technical debt, requirements that are not aligned with tests, and missing infrastructure for continuous integration and continuous testing. ContextQA is positioned to remove that mundane, repetitive work so teams can test more often without writing code.
To do that, ContextQA offers three ways to build a test:
- No-code: a record and play feature that captures your actions in the browser.
- Low-code: write each step in plain English and the platform turns it into an automated action.
- Pro-code: for complex functionality that the other two paths do not cover, write plain JavaScript or Node.js inside the same test case.
Current coverage includes functional testing, API testing, and mobile testing. At the time of this session, mobile testing was in beta. The platform is multi tenant, so each company gets its own database and resources, which keeps data private and lets ContextQA provide dedicated support.
Find the resources, Chrome extension, and documentation
Before building anything, get familiar with where help lives. On the ContextQA website you can sign up for free, then explore the product and the supporting resources.
- Go to the ContextQA website and register with your name, email, and password, or use single sign-on.
- Install the Chrome extension from the link on the site, which opens the Chrome Web Store. The extension is important because it provides the record and validation capabilities.
- Open the documentation, which covers features like API testing, data driven testing, and cross browser testing, with screenshots and step by step instructions.
- Browse the videos and webinars linked on the site for extra context.
The Chrome extension works best with Google Chrome. Edge is also supported, and Safari and Firefox modes are available, with Chrome as the primary supported browser. The platform works well with modern web applications across domains such as e-commerce, healthcare, and technology platforms.
Navigate the dashboard and organize test cases
After you log in, you land on the dashboard. It groups test cases by category and shows pass, fail, and execution information. The navigation bar runs along the top left, starting with the home screen, then the option to create a test case, then the test development screen where the main features live.
When you create a test case, you fill in fields that make large test suites manageable:
- Priority, such as critical, major, or minor.
- Type, such as functional or API.
- Status of the test case.
- Prerequisites to run before this test case, which lets you build modular tests.
- Labels, which let you run specific features or test cases against specific pull requests.
- A test data profile for data driven testing.
On the test case list you can search older tests, sort by name or created date, and filter by criteria like priority and type. Once you build a filter, you can save it so that view is available later from the three dots menu. This organization matters at scale. When a customer has thousands or tens of thousands of test cases, labels, categories, and status are what keep delivery on time.
Create and run a test in plain English
Here is the core flow the session demonstrates. Start from a blank test case and write the steps in plain English.
- Open a new test case so the fields appear empty.
- Type your first step in plain English, for example navigate to a URL.
- Add assertions and low-code templates as you type, for example verify the page title or verify the parent page URL.
- Click Run. ContextQA executes the test automatically, by default in headless mode.
- Open the run to view the result.
Each execution you trigger is recorded so you build a history over time. Open a run and you get a detailed view: a video of the execution, a full trace of what worked and what did not, and screenshots captured step by step.
We do not just want to say that this is failing. We want to tell you why it is failing. That is the context we add to test execution.
When a step fails, ContextQA shows the actual result against the expected result. In the session, a step expected the title to read one value but the page returned a slightly different value, including a difference in case, so the assertion did not match. You can then handle that with a regular expression or another approach. Failed steps are marked clearly, and logs from the execution help whoever is debugging understand what happened. For larger issues, the analysis is connected to generative AI to help find the cause.
Read results: screenshots, visual regression, and self healing
When you create a test, ContextQA automatically takes a screenshot for each action and keeps it as a golden copy. On every later run it captures fresh screenshots and compares them against that golden copy, so visual regressions surface on their own. This matters because no tester has time to check every element on every screen by hand.
Self healing handles small changes for you. If an element changes in a minor way, for example the same login button is present but its ID changed, ContextQA uses AI to find the alternative and the test keeps running. The run is marked as healed so the change stays transparent and you do not need to re-record. If an element is completely missing from the page, the test fails and reports the exact step where the element was not found, along with the video and screenshots you can hand to a developer.
Link test runs and bugs to Jira
ContextQA leans into Jira rather than replacing it. The goal is to make manual test cases, executions, and coverage visible inside Jira so leadership can see what the QA team is doing without leaving their existing tool.
To raise a bug from a failed run:
- In your plugins or integration manager, add your Jira account URL, username, and API key to connect.
- Open the run and click the Jira icon. ContextQA copies the prerequisites and the steps into the ticket.
- Mark it as a bug, let it load the project you are working on, and set priority and due date.
- Click Create. The bug is created in Jira with all the details attached.
Inside Jira, ContextQA is a native application that shows test steps, test coverage based on labels, a performance score, the last update, and the last execution status. Because test cases can be mapped to requirements through labels, you get traceability in both directions, so you can ask whether a requirement has test coverage and trace a failure back to its source.
Capture manual testing so it becomes automation
Not every feature is ready for automation on day one, but everything still needs testing. The session shows how to handle that without losing the work.
- Create a test case in ContextQA even if it is just a placeholder, for example a login screen check, and add whatever notes and flags you have.
- When you do not have time to automate, use Run manually and step through the test yourself.
- Mark each step or the overall test as pass or fail and add the result.
- Add more steps over time during backlog grooming or whenever you find time.
Because you write those steps in the platform as you go, the manual test gradually turns into an automated one. ContextQA captures the execution history whether you ran the test manually or automatically, and that history shows up in Jira. The idea is to put your manual testing effort somewhere that translates straight into automation, without forcing any particular methodology on the team.
Next steps
Sign up for a free ContextQA account, install the Chrome extension, and try the flow from this session: create a test case, write a couple of steps in plain English, click Run, and open the result to watch the video and screenshots. Then connect Jira and create a bug from a failed run. Session 2 builds on this with the Chrome extension recorder, parameterized testing, API testing, and editing test cases in more depth.
Key takeaways
- ContextQA is a no-code, low-code, and pro-code platform for end-to-end test automation, so you can record and play, write steps in plain English, or drop into JavaScript when needed.
- You create a test by typing steps in plain English, then click Run, and the platform executes the test and records a video, screenshots, and a full trace.
- Every action captures a screenshot that becomes a golden copy, so later runs compare against it and surface visual regressions automatically.
- Minor element changes can self heal, and the run is marked as healed for transparency, so you avoid re-recording for small selector changes.
- Test runs and bugs link directly to Jira, which keeps execution history and coverage visible to product and engineering teams.
Frequently asked questions
ContextQA is a software test automation platform for end-to-end testing. It offers no-code record and play, low-code steps written in plain English, and pro-code where you can write JavaScript or Node.js for complex cases. Its current coverage is functional testing, API testing, and mobile testing, with mobile in beta at the time of this session.
No. You can build tests without code by recording actions or by typing steps in plain English. For complex scenarios that the no-code and low-code paths do not cover, you can add plain JavaScript or Node.js in the same test case. This is why ContextQA is described as no-code, low-code, and pro-code.
Open a new test case and start typing steps in plain English in the editor, for example go to a URL or verify the page title. Assertions and low-code templates are available as you type. When the steps are ready, click Run and ContextQA executes the test, by default in headless mode, and records the result.
Click Run on the test case and ContextQA executes the steps automatically. Open the run to see a detailed view with a video of the execution, a full trace, and step by step screenshots. Failed steps are flagged with the actual result and the expected result so you can see exactly where and why the test stopped.
Yes. ContextQA captures a screenshot for each action when you create a test, and keeps it as a golden copy. On later runs it compares the new screenshots against the golden copy and highlights visual changes over time, so you can spot layout shifts without testing every element by hand.
Self healing lets a test keep working when an element changes in a minor way, such as a changed ID while the same login button is still present. ContextQA uses AI to find the alternative and continues the run, and it marks the test as healed for transparency. If an element is completely missing, the test fails and reports the step where the element was not found.
Yes. You do not need to re-record the whole test when something changes. You can edit only the steps you need and add a step before or after an existing one. This reduces the maintenance effort that usually comes with record and play tools.
From a test run you can open the Jira icon, which copies the prerequisites and steps into a new ticket, loads your project, lets you set priority and due date, and creates the bug in Jira. ContextQA is a native Jira application that shows test steps, coverage, performance score, and last execution status inside Jira, which keeps testing visible to product and engineering teams.
Ready to automate your testing?
Put this tutorial into practice. Create your first test in plain English and let ContextQA handle the rest.