Asana Project Table & Filter for Confluence

1. Quick Start (Under 60 Seconds)

1. Open any Confluence Cloud page in Edit mode and type /asana (or paste an Asana project/task link directly onto the page).
2. Choose Asana Project Table & Filter (or Asana Task Status Badge for inline single-task status pills).
3. Click Allow access to authorize read-only OAuth 2.0 access via Atlassian's native Forge credential vault.
4. Select your Asana Workspace and Asana Project directly from the dropdowns and click Pin Project to Page (or paste any Asana project URL in the right-hand macro sidebar).

2. Key Features

• Interactive Live Filtering: Filter embedded Asana tasks on any Confluence page by Status (Incomplete, Overdue, Completed, All), Section, Assignee, or Keyword / Tag Search without editing the Confluence page.
• 1-Click Column Sorting: Click any column header (Status, Task, Section, Assignee, Due Date) to sort live.
• KPI Rollup Strip: Automatically displays total tasks, open count, completion percentage, and overdue alerts.
• Inline Single-Task Status Badge & Auto-Convert: Paste any Asana project or task URL in Confluence to convert it automatically into a live table or inline status lozenge.
• Zero Vendor Server Architecture: Built 100% natively on Atlassian Forge. OAuth tokens are encrypted and refreshed natively by Atlassian Forge, and read-only requests communicate directly with https://app.asana.com.

3. Permissions & Security Architecture

• Atlassian Scopes: storage:app (stores only the selected Asana Workspace/Project ID mapped to each Confluence macro instance) and read:confluence-content.summary.
• Asana OAuth 2.0 Read-Only Scopes: tasks:read, projects:read, workspaces:read, users:read. The app never modifies, creates, or deletes Asana tasks or projects.