Status

Description

Status elements display status indicators with customizable text and colors within ADF documents. They provide visual cues for project states, task completion, approval workflows, and other categorical information. Status elements support various color schemes as defined in the Atlassian Document Format specification.

.md markdown syntax

Basic Status

Status: {status:Complete}
Status: {status:In Progress}
Status: {status:Blocked}

Status with Inline Color Attributes

{status:Ready for Review|color:green}
{status:Needs Attention|color:red}
{status:In Progress|color:yellow}
{status:Available|color:blue}
{status:High Priority|color:purple}
{status:Draft|color:neutral}

Legacy Status with Metadata Comments (Backward Compatibility)

<!-- adf:status color="green" -->
{status:Ready for Review}

<!-- adf:status color="red" -->
{status:Needs Attention}

Multiple Status Types

Priority: {status:High|color:red} {status:Medium|color:yellow} {status:Low|color:green}
Phase: {status:Planning} {status:Development|color:yellow} {status:Testing|color:blue} {status:Complete|color:green}

Syntax Comparison

Feature	Inline Syntax	Legacy Metadata Syntax
Conciseness	{status:Done|color:green}	<!-- adf:status color="green" -->{status:Done}
Readability	✅ Single line, clear intent	❌ Two lines, less readable
Round-trip	✅ Perfect preservation	✅ Perfect preservation
User-friendly	✅ Easy to write and remember	❌ Verbose, hard to remember
Compatibility	✅ Works with all colors	✅ Works with all colors

Recommendation: Use the inline syntax {status:text|color:value} for new content. Legacy syntax is maintained for backward compatibility.

.adf-schema.json schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "status"
    },
    "attrs": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Status display text"
        },
        "color": {
          "type": "string",
          "enum": ["neutral", "purple", "blue", "red", "yellow", "green"],
          "description": "Status color theme"
        },
        "localId": {
          "type": "string",
          "description": "Unique identifier, auto-generated"
        }
      },
      "required": ["text", "color"],
      "additionalProperties": true
    }
  },
  "required": ["type", "attrs"]
}

Examples

Project Status

## Project Dashboard

**Authentication Module**: [Complete]
**Dashboard UI**: [In Progress]  
**API Integration**: [Planning]
**Testing**: [Not Started]

Task Management

## Sprint Backlog

- Implement user login [In Progress]
- Design dashboard wireframes [Complete]
- Set up CI/CD pipeline [Blocked]
- Write API documentation [To Do]

Approval Workflow

## Document Review

**Technical Review**: [Approved]
**Legal Review**: [Pending]
**Management Sign-off**: [Waiting]

Quality Assurance

## Test Results

**Unit Tests**: [Pass]
**Integration Tests**: [Pass]
**Performance Tests**: [Fail]  
**Security Scan**: [Warning]

Release Pipeline

## Deployment Status

**Development**: [Deployed]
**Staging**: [Ready]
**Production**: [Scheduled]

Bug Tracking

## Open Issues

- Login timeout issue [Critical]
- Dashboard loading slow [Medium]
- Typo in help text [Low]
- Search not working [High]

Feature Flags

## Feature Status

**Dark Mode**: [Beta]
**New Dashboard**: [Experimental]  
**Mobile App**: [Coming Soon]
**API v2**: [Deprecated]

Team Availability

## Team Status

**Alice Johnson**: [Available]
**Bob Smith**: [Busy]
**Carol Davis**: [Vacation]
**David Wilson**: [Meeting]

Environment Health

## System Status

**Database**: [Healthy]
**API Server**: [Warning]
**File Storage**: [Critical]
**CDN**: [Operational]

Content Status

## Documentation Status

**User Guide**: [Current]
**API Docs**: [Outdated]
**FAQs**: [In Review]
**Tutorials**: [Draft]

Priority Levels

## Issue Priorities

**Server Down**: [P0 - Critical]
**Feature Bug**: [P1 - High]
**UI Polish**: [P2 - Medium]
**Documentation**: [P3 - Low]

Compliance Status

## Regulatory Compliance

**GDPR**: [Compliant]
**SOX**: [In Progress]
**HIPAA**: [Not Applicable]
**PCI DSS**: [Pending Audit]

Training Progress

## Employee Training

**Security Training**: [Complete]
**Git Workshop**: [Scheduled]
**React Course**: [In Progress]
**Leadership Program**: [Enrolled]

Inventory Status

## Equipment Status

**Laptops**: [In Stock]
**Monitors**: [Low Stock]
**Keyboards**: [Out of Stock]
**Mice**: [Ordered]