Slack Workflow Status

This action posts workflow status notifications into your Slack channel. The notification includes details such as the Actor, Event, Branch, Workflow Name, Status, and Run Durations.

🚀 [NEW] This action now supports uploading and referencing Playwright artifacts (e.g., JUnit test results and report URLs) to provide detailed context about your workflow's execution in the comment thread of the workflow status notification.

Key Features

• Posts workflow status to slack using Slack API (not webhook).
• Includes individual job statuses and durations (optional).
• Includes Playwright (Junit) test result summaries with failure and flake details in comment thread. (optional)
• Includes a report URL for Playwright-based jobs in comment thread. (optional)

Action Inputs

midleman/slack-workflow-status@master

Name	Required	Default	Description
gh_repo_token	Yes	-	GitHub token for authentication, defaults to ${{secrets.GITHUB_TOKEN}}.
slack_token	Yes	-	Slack token for posting notifications.
slack_channel	No	-	Slack channel to send notifications.
notify_on	No	always	Controls when notifications are sent: always, fail-only, never.
include_job_statuses	No	true	Includes job statuses in notifications. Use false to exclude or on-failure for failures only.
include_job_durations	No	true	When true, includes job run times in the Slack notification. Requires: include_job_statuses.
filter_jobs	No	-	Only report jobs matching this regex. Requires: include_job_statuses.
include_commit_msg	No	true	When true, includes the head commit message in the notification.
custom_title	No	-	Override the default slack message title with your own.
comment_junit_failures	No	false	When true, includes JUnit test failures in the Slack notification comment thread.
comment_junit_flakes	No	false	When true, includes JUnit test flakes in the Slack notification comment thread.
emoji_junit_failure	No	:x:	Emoji used for JUnit test failures.
emoji_junit_flake	No	:warning:	Emoji used for JUnit test flakes.
jobs_to_fetch	No	30	Sets the number of jobs to fetch for workflows with a large number of jobs.

Composite Action Inputs

midleman/slack-workflow-status/.github/actions/upload-artifacts@master

Usage of this composite action is optional and only needed if reporting playwright test results in thread of original slack message.

Name	Required	Default	Description
junit_path	No	-	Path to the JUnit test results. Needed in order to add test result details in comment thread.
report_url	No	-	The report URL to save and upload as an artifact. This will be hyperlinked in the comment thread.

Usage

To use this action properly, you should create a new job at the end of your workflow that needs all other jobs in the workflow. This ensures that this action is only run once all jobs in your workflow are complete.

This action requires read permission of actions scope. You should assign a job level actions permission if workflow level actions permission is set none.

See example workflow here.

name: Workflow Example
on:
  push:
    branches: [ main ]

jobs:
  job-1:
  # implement job 1 here

  job-2:
  # implement job 2 here

  job-3-playwright:
    container:
      image: mcr.microsoft.com/playwright:v1.50.0-noble
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
    - run: npm ci
    - run: npx playwright test

    # use this composite action to upload playwright artifacts. these will be used
    # downstream to comment in a thread on the initial workflow summary slack message.
    - name: Save and Upload Artifacts for Slack Notification
      uses: midleman/slack-workflow-status/.github/actions/upload-artifacts@master
      if: ${{ !cancelled() }}
      with:
        job_name: ${{ github.job }}
        junit_path: 'test-results/junit.xml'
        report_url: 'http://www.my-url.html'

  slack-notifications:
    if: always()
    name: Post Workflow Notifications
    needs: 
      - job-1
      - job-2
      - job-3-playwright
    runs-on: ubuntu-latest

    steps:
    # sends the workflow summary slack message. and depending on configuration, it can
    # also comment in a thread with the playwright test results and report hyperlink.
      - name: Post Workflow Status to Slack
        uses: midleman/[email protected]
        with:
          gh_repo_token: ${{ secrets.GITHUB_TOKEN }}
          slack_token: ${{ secrets.SLACK_TOKEN }}
          channel: '#test-results'
          include_junit_failures_in_comment: true
          include_junit_flakes_in_comment: true

Light and Dark Theme