Restrict special characters in tag names when creating tags via Bitbucket Cloud UI

XMLWordPrintable

    • 1

      Summary:
      When creating tags through the Bitbucket Cloud web UI, users should be prevented from including single quotes (') and double quotes (") in tag names, as these characters cause tags to become undeletable through standard Git commands and the REST API.

      Problem Statement:
      Currently, Bitbucket Cloud's web UI allows users to create tags containing single quotes and double quotes. Once created, these tags cannot be deleted by the user through any available method:

      • git push origin --delete <tag_name> — fails due to shell quoting conflicts (both quote types present)
      • git push origin :refs/tags/<tag_name> — same issue
      • Bitbucket REST API (DELETE /2.0/repositories/{workspace}/{repo}/refs/tags/{name}{}) — returns 400 Bad Request
      • Bitbucket Cloud web UI — does not support tag deletion

      The only resolution currently available is backend intervention by Atlassian staff.

      Customer Impact:

      • Users are unable to clean up incorrectly named tags from their repositories
      • Repository tag lists become cluttered with undeletable entries
      • Requires support escalation and backend intervention to resolve, increasing resolution time

      Proposed Solution:
      Add client-side and server-side validation when creating tags via the Bitbucket Cloud web UI to reject tag names containing:

      • Single quote (')
      • Double quote (")

      Optionally, consider restricting other characters that are known to cause issues with shell interpretation (e.g., backtick `, percent %, etc.).

      Alternative Solutions:

      1. Add tag deletion functionality to the Bitbucket Cloud web UI
      1. Improve REST API handling to correctly process URL-encoded special characters in tag names
      1. Display a warning (rather than blocking) when users attempt to create tags with problematic characters

              Assignee:
              Unassigned
              Reporter:
              Chung Jeon
              Votes:
              1 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: