1. Resources
  2. /
  3. Plugins
  4. /
  5. junit-slack-notification-buildkite-plugin

JUnit - Slack notification buildkite plugin

Use “JUnit XML report” to generate Slack notification from Buildkite

This plugin was inspired by junit-annotate-buildkite-plugin which also retrieve JUnit XML reports and process them.

Example

Add an extra step like this after running your tests to your pipeline.yml:

steps:
  - label: Run tests
    key: my-test
    command: ...
    
  - label: ":slack: :memo: to #junit_bot_testing"
    depends_on: my-test
    allow_dependency_failure: true
    plugins:
      - iress/junit-slack-notification#v1.0.8:
          artifacts: "**/*.xml"
          SLACK_TOKEN: "xoxb-xxxxxxxxxxx-xxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx"
          SLACK_CHANNEL: "#junit_bot_testing"

or

steps:
  - label: Run unit tests
    key: my-unit-test
    command: ...
  - label: Run Verification tests
    key: my-verification-test
    command: ...
    
  - label: ":slack: :memo: to #junit_bot_testing"
    depends_on: my-test
    allow_dependency_failure: true
    plugins:
      - iress/junit-slack-notification#v1.0.8:
          test_suites:
              - name: "Unit tests"
                artifacts: "unit-test/**/*.xml"
              - name: "Verification tests"
                artifacts: "verification-test/**/*.xml"
          SLACK_TOKEN: "xoxb-xxxxxxxxxxx-xxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx"
          SLACK_CHANNEL: "#junit_bot_testing"

Configuration

artifacts (Use if no test_suites, string, default **/*.xml )

The file pattern to use to retrieve JUnit XML reports

test_suites (object)

The object containing the JUnit XML reports. The object should be in the following format:

test_suites:
  - name: "Test Suite 1"
    artifacts: "test-suite-1/**/*.xml"
  - name: "Test Suite 2"
    artifacts: "test-suite-1/**/*.xml"

SLACK_CHANNEL (Required, string)

Name of the public Slack channel which your bot will report e.g. #junit_bot_testing

SLACK_TOKEN_ENV_NAME (String)

Name of the environment variable that contains the Slack API token. Default value: "SLACK_TOKEN"

SLACK_TOKEN (string)

The token of your Slack application which is allows chatting on your Slack organisation.

DOCKER_CACHE (string)

If you which to use a Docker registry proxy, specify the path prefix here

EXTRA_SLACK_MESSAGE (string)

Contains an extra message to add on the bottom of the generated message. You can include a variable using the syntax {var}.

EXTRA_SLACK_MESSAGE: "This project has a libyear of {LIBYEAR_DRIFT}"

with LIBYEAR_DRIFT environment variable set to 0.5 will add the message This project has a libyear of 0.5

Create a bot for your workspace.

See Slack documentation Create a bot for your workspace for instruction to create a Slack application.

Here a sample of your slack application manifest sample. Make sure the scope of your bot is allowed to chat:write & chat:write:public

_metadata:
  major_version: 1
  minor_version: 0
display_information:
  name: JUnit Summary Bot
  description: JUnit run summary information
  background_color: "#000000"
features:
  bot_user:
    display_name: JUnit Summary Bot
    always_online: false
oauth_config:
  scopes:
    bot:
      - chat:write
      - chat:write.public
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

Developing

To start development, install dependency package and compile typescript

npm install
npm run build

To run unit tests in Jest

npm run test

Contributing

  1. Fork the repo
  2. Make the changes
  3. Run the tests
  4. Commit and push your changes
  5. Send a pull request

Licence

MIT License (See the included Licence file for more information).

The plugins listed on this webpage are provided for informational purposes only. They have not undergone any formal security review or assessment. While we strive to provide useful resources, we cannot guarantee the safety, reliability, or integrity of these plugins. Users are strongly advised to conduct their own security evaluations before downloading, installing, or using any plugin. By using these plugins, you acknowledge and accept any risks associated with their use. We disclaim any liability for any harm or damages arising from the use of the plugins listed.

Start turning complexity into an advantage

Create an account to get started with a 30-day free trial. No credit card required.

Buildkite Pipelines

Platform

  1. Pipelines
  2. Pipeline templates
  3. Public pipelines
  4. Test Engine
  5. Package Registries
  6. Mobile Delivery Cloud
  7. Pricing

Hosting options

  1. Self-hosted agents
  2. Mac hosted agents
  3. Linux hosted agents

Resources

  1. Docs
  2. Blog
  3. Changelog
  4. Webinars
  5. Plugins
  6. Case studies
  7. Events
  8. Migration Services
  9. Comparisons

Company

  1. About
  2. Careers
  3. Press
  4. Brand assets
  5. Contact

Solutions

  1. Replace Jenkins
  2. Workflows for AI/ML
  3. Testing at scale
  4. Monorepo mojo
  5. Bazel orchestration

Legal

  1. Terms of Service
  2. Acceptable Use Policy
  3. Privacy Policy
  4. Subprocessors
  5. Service Level Agreement

Support

  1. System status
  2. Forum
© Buildkite Pty Ltd 2025