Get Started

Sign Up for a Free Trial

  1. Head to the VisualTest free trial page

    VisualTest login screen
  2. Complete the required fields.


    Your entity's VisualTest account is linked permanently to the email address you use in this step.

  3. Check your inbox for the confirmation email.

  4. Click the verification link in your email. It opens the VisualTest login screen.

  5. Log in with your SmartBear credentials.

When you first launch VisualTest, an Example Project is loaded automatically to give you a first look at the functionality:

VisualTest Example Project

Configure VisualTest

To configure VisualTest, you need to:

  1. Generate a project-specific token.

  2. Integrate VisualTest into your automated UI tests.

  3. Run VisualTest.

  4. Review differences found.

Generate Project Token

  1. At launch, VisualTest shows the Projects screen. Click on Create Project and name your Project, as shown below:

  2. Optionally, choose which comparison modedetailed or layout – you want for your project. This can be changed later in Settings. For more information on comparison modes, see the Comparisons section.

  3. Click Create. VisualTest generates your project and a project-specific token.

  4. Copy your project token, as in the following image. You need this to integrate VisualTest into your functional test scripts.

    Copy project token

    The following video shows these steps:

If ever you need to find your project token later, it is available from project settings:

Find VisualTest Project Token

Integrate VisualTest into Your UI Tests

To integrate VisualTest into your UI tests:

  1. Install one of the Software Development Kits (SDKs) to add screenshot capture commands where you'd like to add visual coverage.

    The following video gives an example of inserting the project token into your script.

  2. Choose from one of the following capture formats:

    • Fullpage – captures the whole page

    • Viewport – captures the visible portion of the page

    • Element – captures a specific visual element

Run Your Tests

VisualTest is designed to run using your existing functional UI test flows and framework. Simply run your VisualTest integrated test scripts using your test framework’s command of choice, either locally or via any CI/CD systems.

The following video shows an example of running a test.

Regardless of how you run your tests, VisualTest creates a new tile to show any found image differences for your review:


Review Any Visual Differences

Review found differences in the VisualTest platform. Click on your project to open the Test Run screen:

Test Runs screen

Your team can find all your test runs in any given Project, listed chronologically by default, as in the orange box above.

Each test run presents at a high level all the images that need review, and each review status is timestamped. Any team members who have access to the VisualTest platform can approve or reject any of the visual differences found.

Difference approval screen

See Also

Publication date: