Home Issue Create Issue Keys

Create Issue Keys

Last updated on Dec 28, 2025

Every task deserves a unique identity. Issue Keys ensure clarity, consistency, and accurate tracking.

Issue Keys are unique alphanumeric codes that are automatically assigned to every issue (task) in your project. These keys serve as fixed identifiers, simplifying communication, tracking, and integration across your entire workspace. Oktuple generates them by default, and they cannot be changed — ensuring that every task remains clearly identifiable throughout its lifecycle.

Or in the subtasks:

🆔 Why Issue Keys Matter

| Purpose | Description |

| 🔍 Easy Task Tracking | Quickly locate, reference, and search for tasks using their Issue Key. |

| 🔗 Clear Communication | Refer to tasks unambiguously in discussions, comments, and reports. |

| 🚫 Avoid Duplication or Errors | Ensure every task is uniquely identified, preventing overlap or confusion. |

| 🧩 Integration-Ready | Issue Keys can be used in integrations, reports, and automation workflows without breaking references. |

🛠️ Structure of Issue Keys

Oktuple automatically creates Issue Keys in the following format:

ABC-123

  • ABC: A short project prefix (usually 2–4 uppercase letters)

  • 123: A sequential number unique to that project

This structure is:

  • ✅ Simple

  • ✅ Human-readable

  • ✅ System-friendly

⚙️ How Issue Keys Work in Oktuple

  • Automatically Generated: A new Issue Key is assigned to each task as soon as it’s created.

  • Non-Customizable: You cannot change, rename, or restructure an Issue Key.

  • Globally Unique per Project: Each Issue Key is unique within its project and remains fixed.

  • Permanent Reference: Even if task details change, the Issue Key remains the same.

🔒 Why Issue Keys Cannot Be Modified

Modifying an Issue Key could have serious consequences in terms of data accuracy and team coordination. That’s why Oktuple prevents any alteration to these identifiers.

🚫 Risks of Changing Issue Keys:

  • ❌ Tracking Confusion: Team members may lose track of updated or renamed tasks.

  • ❌ Broken Links: Internal or external references to tasks might stop working.

  • ❌ Inconsistent Reports: Analytics and progress reports could show errors.

  • ❌ Reduced Transparency: Collaboration between teams becomes more error-prone.

🔐 The Stability You Can Trust

Fixed Issue Keys are a pillar of reliable task management. By keeping these identifiers constant:

  • You ensure historical accuracy across the project's timeline

  • You maintain clear traceability from creation to completion

  • You eliminate ambiguity in team conversations, audits, or support

✅ Key Takeaways

  • Issue Keys are automatically assigned to all issues.

  • They follow a standard format and are non-editable.

  • They ensure clarity, consistency, and reliability across your workspace.

  • Oktuple’s fixed key system is designed for team alignment, reporting accuracy, and seamless integration.