Percy for Slack: Get notified when visual changes are detected and approved

Rylee Keys
Percy Blog
Published in
3 min readJun 5, 2019

Visual testing is a crucial component of how teams review code. Reviewing designs and UI updates before deployment and inspecting visual changes for regressions is a team effort.

Up until now, Percy notifications have come exclusively through pull requests status updates — which works great if you’re looking at GitHub all day.

For everyone else, we’re excited to bring visual reviews to the tool you’re already collaborating in — Slack. Now everyone from developers and UX designers to product managers and marketers can get visibility into every visual review.

Slack connections and notifications

Everyone uses Slack differently, so we built our integration to be customizable to fit any team’s needs.

By default, we send notifications when a build is “Unreviewed,” meaning it has finished and has visual changes to be reviewed.

If and when those changes are reviewed and approved, the original corresponding notification will be updated.

In addition to “Unreviewed” notifications, Percy for Slack currently supports these notifications types:

  • No changes: Get notified when builds finish with no visual changes.
  • Auto-approved: Get notified when builds are auto-approved from your auto-approved branches.
  • Approved: Get additional notifications — in addition to the Unreviewed notification update — when builds are approved.

You can configure unlimited connections between Percy projects and Slack channels, customizing which notifications get sent where.

For example: Maybe you want to send all those notifications to your #code channel (or maybe a new #visual-testing channel), but limit #design channel notifications to just when visual changes are detected.

You can do that!

Setting up Percy for Slack

Head to your Percy Organization Settings > Integrations, and click to connect. You’ll be able to add Percy to any Slack workspace for which you have permission to install apps or custom integrations.

Choose the Percy project (or all projects) you’d like to connect and the Slack channel you want to configure, then select the notifications you wish to send!

Percy will start sending notifications to Slack when your next Percy build is finished or approved. With Percy for Slack, it’s easy to keep your whole team — designers, product managers, and marketers included — on the same page while reviewing and approving visual changes as part of every code review.

We look forward to adding more supported notifications as we build out our platform to better support visual review collaboration! Feel free to reach out with questions.

Percy is an all-in-one visual testing solution that gives your team confidence in every visual change before it’s shipped. Learn more at https://percy.io. 👀

--

--