October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk5 min

How to Test a Staging Site Against Production with BackstopJS

Use production as BackstopJS’s reference and staging as its test target. Configure url and referenceUrl, run the reference and test commands, then review before approving changes.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Set each BackstopJS scenario’s url to the staging page and its referenceUrl to the matching production page. Run backstop reference to capture production, then backstop test to compare staging against that baseline. Inspect the visual report and approve only changes your team intends to keep.

How the staging-versus-production comparison works

BackstopJS uses two captures for each scenario: a reference image and a test image. In this workflow, production supplies the reference and staging supplies the test. The difference report highlights visual changes; it does not determine whether a difference is a bug or an intended update.

As an Amazon Associate I earn from qualifying purchases.

The scenario’s url is the page captured during a test run. Its optional referenceUrl is the corresponding page captured by backstop reference. This separation lets one scenario compare two environments.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Set up BackstopJS and define scenarios

  1. Install BackstopJS in your project or use its existing project installation. Initialize configuration with backstop init, as described in the BackstopJS README.

    #1 Best Overall
    Website Testing Software Developer Website Tester Graphic Laptop Sleeve
    • Website Testing Software Developer Website Tester. This Quality Assurance: My Superpower is for men and women into website testing. Great for a website tester who test and evaluate websites or web applications.
    • Are you a software developer in programming? Are you a web tester who ensure websites functionality? Then this website testing design is for you. Ideal website tester apparel for a computer programmer.
    • Lightweight, form-fitting laptop sleeve that protects your laptop from daily wear and tear
    • Faux fur-lined interior and padded zipper binding prevent scratches while keeping your device secure with a top-loading zippered enclosure and two sliders
    • Designed for on-the-go use with a slim profile that easily slides into backpacks, totes, and carry-on bags
  2. In the generated configuration, create scenarios for the routes you need to check. Give each scenario a recognizable label, set url to the staging route, and set referenceUrl to its production counterpart.

  3. Configure at least one viewport for each scenario. Keep scenario labels and viewport names stable so report entries and screenshot files remain easy to identify between runs.

For example, the essential scenario settings should follow this pattern (use the property names within the scenario structure created by your installed BackstopJS version):

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
  • Website Testing Software Developer Website Tester. This Test Like A Boss is for men and women into website testing. Great for a website tester who test and evaluate websites or web applications.
  • Are you a software developer in programming? Are you a web tester who ensure websites functionality? Then this website testing design is for you. Ideal website tester apparel for a computer programmer.
  • Lightweight, form-fitting laptop sleeve that protects your laptop from daily wear and tear
  • Faux fur-lined interior and padded zipper binding prevent scratches while keeping your device secure with a top-loading zippered enclosure and two sliders
  • Designed for on-the-go use with a slim profile that easily slides into backpacks, totes, and carry-on bags
{
  "label": "Product page",
  "url": "https://staging.example.com/products/widget",
  "referenceUrl": "https://www.example.com/products/widget"
}

This illustrates the endpoint mapping only. Add the viewport and capture settings required by your project configuration; the README is rolling documentation, so check it or the documentation bundled with your installed version for exact configuration details.

Choose what each scenario captures

Capture scope should match the risk you want to inspect. BackstopJS supports document for the whole page, viewport for the current visible area, and element selectors for a component or page region.

  • Whole document: useful when changes may affect the full page, including content below the fold.
  • Viewport: useful when the visible initial screen is the specific comparison target.
  • Element: useful when a change is limited to a component or defined region.

Choose routes and viewports deliberately: a broad capture can reveal unexpected page-wide changes, while focused element captures can make a component-level change easier to review. There is no single coverage configuration that fits every site.

Rank #3
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
  • Website Testing Software Developer Website Tester. This Quality Assurance: My Superpower is for men and women into website testing. Great for a website tester who test and evaluate websites or web applications.
  • Are you a software developer in programming? Are you a web tester who ensure websites functionality? Then this website testing design is for you. Ideal website tester apparel for a computer programmer.
  • Lightweight, form-fitting laptop sleeve that protects your laptop from daily wear and tear
  • Faux fur-lined interior and padded zipper binding prevent scratches while keeping your device secure with a top-loading zippered enclosure and two sliders
  • Designed for on-the-go use with a slim profile that easily slides into backpacks, totes, and carry-on bags

Capture production, test staging, and review the report

  1. From the project’s BackstopJS installation, run backstop reference. This captures the configured production URLs through referenceUrl and creates or refreshes the reference images.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  2. Run backstop test. BackstopJS captures the staging URLs in url, compares those test bitmaps with the current references, and produces a visual report.

  3. Review each reported difference in context. Decide whether it is an intended staging change, an unwanted regression, or rendering variation before taking action.

    Rank #4
    Website Testing Software Developer Website Tester Graphic Laptop Sleeve
    • Website Testing Software Developer Website Tester. This Test Like A Boss is for men and women into website testing. Great for a website tester who test and evaluate websites or web applications.
    • Are you a software developer in programming? Are you a web tester who ensure websites functionality? Then this website testing design is for you. Ideal website tester apparel for a computer programmer.
    • Lightweight, form-fitting laptop sleeve that protects your laptop from daily wear and tear
    • Faux fur-lined interior and padded zipper binding prevent scratches while keeping your device secure with a top-loading zippered enclosure and two sliders
    • Designed for on-the-go use with a slim profile that easily slides into backpacks, totes, and carry-on bags
  4. If the differences are intentional and accepted, run backstop approve. This promotes the latest test captures into the reference collection for subsequent comparisons.

Approving is not just dismissing a report: it changes the baseline. The BackstopJS README states, “Approving changes will update your reference files with the results from your last test.” Do not approve unresolved differences if later tests should continue to compare against the previous production baseline.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Keep the rendering environment consistent

Differences in browser or operating environment can introduce visual variation unrelated to the site change. The BackstopJS README recommends Docker when cross-machine rendering differences are a concern. Use a consistent rendering setup for reference and test captures where possible.

Best Value
ChargerLAB Power-Z KM003C Portable USB-C Fast Charging Tester PD3.2 QC5.0 Digital Voltmeter & Ammeter Power Bank Tester
  • 【PD3.2】This is the POWER-Z product page. This tester is the latest version and can support PD3.2.
  • 【Larger Display】It has a larger LCD display (1.54 inches) than previous generaion and can support gravity rotation. The high contrast UI makes it easier to get what you need.
  • 【Multiple Tests】This tester can support multiple tests, including voltage/current detection, capacity/energy test, E-marker test, PDO test, protocol test, etc.
  • 【More Powerful】This tester integrates ARM Cortex-M4 processor and 20 bit ADC. It can support up to 50V 6A (240W in PD) and USB PD protocol analyzer. The PC software can obtain 10 million pieces of data at a time.
  • 【Designed for USB-C】It's equipped with two USB-C ports for current input & output and an additional HID port (USB-C) for connecting to PC & power supply.

When running Docker, remember that localhost inside the container may not point to the host machine. The README gives host.docker.internal as an alternative on Mac and Windows. If a target is unreachable from the container, check the URL as seen from inside that environment rather than assuming the host’s localhost address will work.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Common problems and practical fixes

  • Staging is being compared to staging, or production to production. Check the mapping: url must be staging for test captures, and referenceUrl must be the production counterpart for reference captures.
  • A route is missing or does not load during capture. Verify that both environment URLs are reachable from the machine or container running BackstopJS, and that the paths point to equivalent pages.
  • The report shows many small differences across machines. Rendering environments may differ. Align the environment used for captures or use Docker as the README recommends for reducing cross-machine variation.
  • Docker cannot reach a host-served site at localhost. On Mac and Windows, try the README’s host.docker.internal alternative and confirm the service is accessible from the container.
  • A component change is obscured by unrelated page differences. Consider whether an element selector is a better capture scope than the whole document, while retaining broader scenarios for risks that extend beyond that component.
  • Future comparisons stop showing an accepted difference. Check whether backstop approve was run: it replaces the reference collection with the latest test captures.

Use ScreenshotNeo when you need a direct screenshot API

BackstopJS is the do-it-yourself visual regression workflow above. For a one-off screenshot or an API-driven capture alongside that process, ScreenshotNeo returns a screenshot or PDF from one GET request. The following cURL example saves a WebP capture of a page; see the ScreenshotNeo API documentation for the available request parameters.

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

ScreenshotNeo can accept cookie or consent banners and remove more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each of those steps can be turned off. Bot checks and CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and responses include X-Page-Verdict and X-Billed headers. Its MCP server includes take_screenshot, get_page_info, and capture_pdf tools for AI agents and other MCP clients.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The free plan includes 1,000 screenshots per month with no card required. Paid plans start at $5 for 3,000 screenshots; every feature is available on every plan. Sign up for ScreenshotNeo’s free plan.

Using BackstopJS in CI

The BackstopJS README documents reporting and CI options, but whether visual differences should block a release is a team decision. Define which scenarios and viewports are release-critical, who reviews flagged changes, and when an accepted change should replace the baseline. Keep that approval decision distinct from the act of capturing or generating a report.

Quick Recap

Bestseller No. 1
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
Lightweight, form-fitting laptop sleeve that protects your laptop from daily wear and tear
$25.99
Bestseller No. 2
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
Lightweight, form-fitting laptop sleeve that protects your laptop from daily wear and tear
$25.99
Bestseller No. 3
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
Lightweight, form-fitting laptop sleeve that protects your laptop from daily wear and tear
$25.99
Bestseller No. 4
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
Website Testing Software Developer Website Tester Graphic Laptop Sleeve
Lightweight, form-fitting laptop sleeve that protects your laptop from daily wear and tear
$25.99

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.