Dashboard User Manual

A comprehensive guide to using the Bitbucket Deployment Dashboard

Overview

The Bitbucket Deployment Dashboard provides a centralized view of all your deployment environments across multiple projects and repositories. It helps you monitor deployment status, track changes, and manage deployments efficiently.

Key Features:

  • View deployments across multiple workspaces and projects
  • Monitor deployment status for Test and Production environments
  • Track commit messages and pipeline numbers
  • Quick access to deploy to production
  • Customizable project and repository selection

Workspace Selection

At the top of the dashboard, you can select which Bitbucket workspace to view. The dashboard will remember your last selected workspace.

💡 Tip:

If no workspace is saved, the dashboard automatically selects the first workspace in your list.

Project Management

Adding/Removing Projects

You can control which projects are displayed on your dashboard:

  • Add a project: Click the project button (with icon) to add it to your view
  • Remove a project: Click the highlighted project button (with icon) to remove it
  • Your project selections are saved automatically and persist across sessions

Collapsing/Expanding Projects

Each project card can be collapsed or expanded using the / button in the project header. This helps you focus on specific projects while keeping others hidden.

Repository Management

Showing/Hiding Repositories

Within each project, you can control which repositories are visible:

  • Checkbox: Each repository has a checkbox next to its name
  • Checked: Repository is visible in the table
  • Unchecked: Repository is hidden from view

Adding Hidden Repositories

If you have hidden repositories, you can add them back:

  1. Look for the "Add Repository" dropdown at the top of the project table
  2. Select the repository you want to add from the dropdown
  3. Click the Add button

Understanding Deployment Status

Each deployment is displayed with a status badge indicating its current state:

SUCCESSFULDeployment completed successfully
FAILEDDeployment failed or encountered an error
IN PROGRESSDeployment is currently running
UNKNOWNStatus could not be determined

Deployment Information

For each repository and environment, the dashboard displays:

  • Status Badge: Current deployment status (Successful, Failed, In Progress, etc.)
  • Pipeline Number: The pipeline number or name (e.g., #123)
  • Commit Information: Short commit hash and commit message
  • Deployment Date: When the deployment was created

⚠️ Important:

For Production environments, only successful deployments are shown to ensure you always see the latest stable deployment.

Production Deployment Indicator

The dashboard uses color coding to help you quickly identify production deployment status:

Green Background

Production is up-to-date with Test environment (same pipeline number)

Yellow Background

Production is behind Test environment (different pipeline number)

💡 Tip:

When production has a yellow background, a "Deploy to Prod" button will appear in the Actions column, allowing you to quickly navigate to Bitbucket to deploy the latest changes.

Deploy to Production

When Test and Production environments have different pipeline numbers, a "Deploy to Prod" button appears in the Actions column.

Clicking this button will:

  1. Open the Bitbucket deployments page for that repository in a new tab
  2. Allow you to trigger a production deployment directly in Bitbucket

⚠️ Note:

The actual deployment must be triggered in Bitbucket. The dashboard provides quick access but does not trigger deployments directly.

Refreshing Data

To get the latest deployment information:

  1. Click the Refresh button in the top-right corner
  2. The dashboard will reload all deployment data for your selected projects
  3. The button will show a spinning animation while refreshing

💡 Tip:

The dashboard automatically loads data when you first open it or change workspaces. Use the Refresh button to get updates after deployments have been triggered.

Settings

Click the Settings button in the dashboard header to:

  • Update your Bitbucket OAuth credentials
  • Clear saved credentials
  • Manage cookie consent preferences

For help setting up OAuth credentials, visit the .

Troubleshooting

No Deployments Showing

  • Ensure the repository has deployment environments configured in Bitbucket
  • Check that deployments have been run for the repository
  • Try refreshing the data using the Refresh button

Session Expired

  • If you see a session expired message, click "Sign in again"
  • You will be redirected to re-authenticate with Bitbucket

OAuth Errors

  • Verify your OAuth credentials are correct in Settings
  • Ensure your OAuth consumer has the correct permissions (account, repository, pipeline)
  • Check that the callback URL is correctly configured in Bitbucket
  • Refer to the for detailed instructions

Data Persistence

The dashboard saves your preferences locally in your browser:

  • Selected Workspace: Your last selected workspace
  • Selected Projects: Which projects you have chosen to display
  • Collapsed Projects: Which projects are collapsed/expanded
  • Repository Visibility: Which repositories are shown/hidden within each project
  • OAuth Credentials: Stored securely in HTTP-only cookies

💡 Note:

Your preferences are stored per workspace, so you can have different project selections for different workspaces.