Ora

How Do I Delete a Board in a Jira Company-Managed Project?

Published in Jira Board Management 3 mins read

Deleting a board in a Jira company-managed project is a straightforward process that removes a specific view of your issues without affecting the issues or the project itself.

Step-by-Step Guide to Deleting a Jira Board

Follow these steps to successfully delete a board from your company-managed project:

Prerequisites

Before you begin, ensure you have the necessary permissions. Typically, you need to be a Project Administrator for the project the board is associated with, or a Jira Administrator for the entire Jira instance.

Detailed Deletion Steps

  1. Access the Boards List:

    • Navigate to your Jira instance.
    • Click in the search field (or press /) on your keyboard.
    • From the search results or quick access options, choose "View all boards." This will display a list of all boards you have access to across various projects.
  2. Locate Your Board:

    • Once on the "View all boards" page, find your board by scrolling through the list or using the search/filter options if available. Make sure you select the correct board, as deletion is irreversible for the board itself.
  3. Initiate Deletion:

    • Next to the name of the board you wish to delete, you'll see a "More options" icon, typically represented by three horizontal or vertical dots (... or ⋮).
    • Select this "more" icon.
    • From the dropdown menu that appears, click on "Delete."
  4. Confirm Deletion:

    • A confirmation dialog box will appear, asking you to confirm that you want to delete the board.
    • Read the warning carefully to understand the implications (e.g., that issues will not be deleted).
    • Click "Delete" again to finalize the process.

Once confirmed, the board will be permanently removed from your Jira instance.

Important Considerations Before Deleting a Board

While deleting a board is simple, it's crucial to understand its implications:

  • Permissions are Key: Only users with appropriate administrative permissions (Project Administrator for the specific project, or Jira Administrator globally) can delete a board. If you don't see the "Delete" option, you likely lack the necessary permissions.
  • Board vs. Project Deletion: Deleting a board does not delete the project or any of the issues within it. It merely removes a specific view (like a dashboard) of those issues. All your issues and their data remain intact within the project.
  • No Undo Option: Once a board is deleted, it cannot be recovered. If you need that specific board configuration again, you would have to recreate it from scratch. Consider taking screenshots of its column configurations and filters if you think you might need them later.
  • Impact on Users: All users who relied on that specific board for their work will no longer have access to that view. Inform your team members in advance to prevent disruption.
  • Alternative: Renaming or Reconfiguring: If you no longer need a board because its purpose has changed, consider renaming it or reconfiguring its filters and columns instead of deleting it entirely. This can save time if a similar board is needed in the future.

What Happens When You Delete a Board?

When you delete a board in Jira, you are essentially removing a configuration that provides a specific perspective on your project's issues. This includes:

  • The board's column configurations and their mappings to workflow statuses.
  • Any quick filters defined for the board.
  • Swimlanes, card layouts, and other board-specific settings.
  • The filter query that defines which issues are displayed on the board.

The underlying issues, projects, and their associated data (comments, attachments, history) remain completely unaffected and accessible through other boards, issue search, or different project views.

For more detailed information on managing boards, refer to Atlassian's official documentation on configuring a board.