Confluence is a powerful collaboration tool I’ve used to track action items and meeting minutes across various projects and programs. Whether you’re managing a single agile sprint or overseeing a complex multi-project program, keeping track of who owes what, and by when, is one of the most critical (and often most painful) parts of project management.
- Capture actions where the work happens: type [] and a space on any status or meeting page, @mention the owner and type // to pick the due date.
- One label ties the pages together: put the same label, such as actions-log, on every page that holds action items. Labels are always lower case.
- The Task Report macro builds the master list: filter by space, label, assignee and status, sort by due date, and it updates itself as people tick their tasks.
- Use two reports: incomplete tasks for the weekly status review, completed tasks as an audit trail for phase gates and lessons learned.
In our last article, I showed you how to build a project status reporting dashboard for large projects or programs. I’ve included my Overall Portfolio status and supporting Portfolio Action items in the snapshot below.
Example of Overall Portfolio status and supporting Portfolio Action items
During program status reviews, each project manager would present project status, and action items were identified and captured in Confluence. The action items were quickly gathered across multiple Confluence pages and Confluence spaces using the Confluence Task Report macro. As team members completed their action items, the list was automatically updated before the next status review. Let’s get started with some simple Confluence task tracking.
Updated November 2026 for the current Confluence Cloud editor. Where Confluence Data Center works differently, the steps say so.
Why Use Confluence for Action Item Tracking?
Before diving into the steps, it’s worth understanding why Confluence stands out as an action item tracking tool compared to alternatives like spreadsheets or standalone task managers. Traditional approaches all suffer from the same core problem: they require manual upkeep. Common culprits include:
- Emailing a list of action items after a meeting
- Maintaining a shared Excel file that only one person updates
- Relying on a whiteboard that gets erased before everyone sees it
- Pasting action items into a chat thread that gets buried within hours
In large programs with multiple project managers and dozens of stakeholders, this becomes unsustainable quickly. Confluence solves this by embedding tasks directly into the pages where the work is documented: meeting minutes, project status updates and sprint retrospectives. Any Confluence page can hold live tasks that aggregate automatically into a master list. The result is a self-maintaining action item registry that updates in real time as team members check off completed items.
This is particularly valuable in PMO (Project Management Office) environments, where a program director needs visibility across five, ten, or even twenty concurrent projects without chasing down individual project managers for updates.
The whole system in four steps. Each project page keeps its own tasks; one Task Report collects them for the program.
Step 1. Create a Task List on a Page
The task list is created by formatting a line of text with the Action item icon (the checkbox) in the editor toolbar. Project managers create individual task lists for each status report.
Editor toolbar: the checkbox icon creates an action item. Every toolbar control is also available by typing /. Source: Atlassian Support.
Use these shortcuts to speed up task creation:
- Type [] followed by a space to start a new action item (or type /action item).
- Type @ and a name to assign the action. The person is notified, and the task appears in their Tasks list.
- Type // to open the date picker and set the due date.
A new action item: type the action, then @mention the owner. Source: Atlassian Support.
Assigning with @: pick the owner from the list of suggestions. Source: Atlassian Support.
Below is a simple task list with people assigned and target dates identified.
A task list on a page: each item has an owner and a due date. Dates due within 7 days turn orange; overdue dates turn red. Source: Atlassian Documentation.
Go ahead and create your task list and publish the page.
Practical Tip: Be as specific as possible when writing action item descriptions. Instead of writing “Follow up on vendor contract,” write “Follow up with procurement team on Oracle vendor contract renewal: confirm pricing by EOD Friday.” The more context baked into the task itself, the less back-and-forth is required when someone reads it cold a week later.
For teams using Confluence alongside Jira, you can also reference Jira issue keys directly in task descriptions. This creates a natural bridge between high-level program action items and the underlying development tickets, giving technical stakeholders the traceability they need.
Step 2. Create a Label for the Page
Labels are the glue that holds this entire system together. They allow the Task Report macro to pull tasks from across multiple pages and spaces into a single unified view. To add a label in Confluence Cloud:
- Open the page and select the Details icon in the floating action bar at the bottom right (or press Ctrl + Alt + A on Windows, Ctrl + Option + A on Mac)
- Select + next to Labels and type actions-log or some other variant
- Press Enter to add the label
In Confluence Data Center, press the L key while viewing the page (or use the label section at the bottom of the page), create the label and click Close.
Details panel: select + next to Labels to add one. Source: Atlassian Support.
Labeling conventions matter. If you’re managing a large program, consider a structured labeling taxonomy from the start. Confluence stores labels in lower case and turns spaces into hyphens, so plan names that read well that way. For example:
actions-log: General project action items.steering-committee: Items escalated to executive sponsors.team-meetings: Recurring team meeting follow-ups.risk-actions: Action items tied specifically to risk mitigation.
Consistent labels make it easy to generate targeted reports for different audiences: one view for the project team, another for the steering committee, and a third for the PMO dashboard. The small investment in naming conventions upfront pays dividends throughout the program lifecycle.
Each page carries one label. Each audience gets a Task Report filtered on the labels it cares about.
Step 3. Insert the Task Report Macro into the Portfolio Page
Refer back to the Portfolio status page. You can create separate pages, but I like associating the action items with all the projects within a program. To insert and configure the Task Report macro:
- Edit the page, type /task report and select the Task report macro (in Data Center, choose Insert > Other Macros)
- In Space(s) and page(s), enter the spaces or pages that contain the desired checklists
- Select the relevant space. In my example, I’ve selected the EPMO space
- Enter the actions-log label in Label(s)
- Set Task status to Incomplete
- Select the number of tasks to display: 10, 20 or 40
- Choose the columns to display. I use the standard description, due date, assignee, and location fields
- Select the Sort by option
- In Data Center, click the Preview icon to refresh the list. In Cloud, changes apply as you go
- Click Publish (or Save in Data Center)
In page edit mode, the Task Report settings look like the following snapshot.
Task Report settings: the filters on the left, a preview of the matching tasks on the right. Confluence Cloud shows the same fields in a side panel. Source: Atlassian Documentation.
When you publish the page, the list of open action items from all the projects in the Confluence space with the actions-log label will be displayed automatically.
The published report: open action items sorted by due date, with the owner beside each one. Source: Atlassian Documentation.
Sorting Strategy: I recommend sorting by due date ascending. This puts the most overdue and soonest-due items at the top of the list, which naturally focuses the team’s attention during status meetings. If you have a particularly large program, a secondary view sorted by assignee can help you quickly identify if any one person has a disproportionate number of open items.
Note: the Task Report macro does not work in Confluence live docs yet. Add it to a regular page, or convert the live doc to a page first.
Watch: Managing Tasks in Confluence
This short walkthrough covers action items, Task Reports and how they connect to Jira issues, in under three minutes.
Video by Vectors Software on YouTube: How to Manage Tasks in Confluence.
Free Confluence Task Report Builder
Not sure which settings to use? Pick a starting example, change the filters and preview the report on a sample program with 3 spaces and 18 action items. When the preview looks right, copy the exact values into your Task Report macro.
Step 4. Manage Completed Actions
If you want to view a separate list of completed actions, copy the same macro and change the Task Status to Complete. Add the Completed date column so you can see when each item closed. This is more useful than it might initially seem. A completed action item list serves as a lightweight audit trail that’s particularly valuable during:
- Phase-Gate Reviews: Demonstrate what was committed to and delivered.
- Lessons-Learned Sessions: Trace patterns in how issues were resolved.
- Mid-Engagement Handoffs: Help a new project manager get up to speed quickly.
- Stakeholder Reporting: Show sponsors a concrete record of follow-through.
Consider placing the completed actions macro inside an expand section (type /expand) on the portfolio page, so it’s available for reference without cluttering the primary view during active status reviews.
Managing Multiple Labels and Multiple Teams
Projects and program teams can manage tasks by applying proper labels and developing different task reports tailored to different audiences. For example, I once created two pages in Confluence, one for regular team meetings and one for steering committee sessions, and tagged them with the labels team-meetings and steering-committee, respectively. Each page had its own set of tasks as action items.
To pull tasks from both pages into a single report, simply add each label separated by a comma in the Label(s) box of the Task Report macro. This gives leadership a unified view while still allowing each team to manage its own page and workflow independently. This multi-label approach scales gracefully. A program with eight project workstreams can have eight labeled pages, all feeding a single portfolio-level task report, giving the program director one consolidated place to review outstanding items across the entire initiative.
Troubleshooting: Tasks Missing From Your Task Report
When a project manager says “my action item isn’t in the report,” the cause is almost always one of these.
Task Report problems project managers hit most often
Find the symptom, then apply the fix.
| What you see | Why it happens | How to fix it |
|---|---|---|
| A task is missing from the report | The page does not carry the label, or the label is spelled differently. | Open the page Details panel and add the exact label used in the macro, for example actions-log. |
| A task you typed never shows up | The action item has no text, only a checkbox or a mention. | Add a description. Tasks with no text are left out of Task Reports. |
| A stakeholder sees fewer tasks than you | They cannot view one of the spaces or pages the report reads. | Check their space and page permissions. Each viewer sees only tasks they have access to. |
| Ticked tasks still appear as open | Task data has not synced after the change. | Publish the source page and the report page again, or untick and re-tick the task. |
| You cannot find the Task Report macro | You are editing a live doc. | Convert the live doc to a page, then insert the macro. |
| Tasks from another project space are missing | Only the current space is in Space(s) and page(s). | Add every project space to the field, separated by commas. |
| The report stops at 20 rows | Number of tasks to display is set to the default of 20. | Choose 40, or tighten the filters so the list stays readable. |
| Created after returns nothing | The date was typed in the wrong format. | Enter it as dd-mm-yyyy, for example 01-11-2026. |
| The Due date column is empty | The action items have no date. | Type // in each task and pick a due date. |
| Overdue items sit at the bottom | Reverse sort is ticked, or the sort is by assignee. | Sort by Due date and untick Reverse sort. |
Sources: Atlassian Support: Task Report macro, Atlassian Documentation: tasks, Atlassian knowledge base: task sync.
Tips for Keeping the System Healthy
Even the best Confluence setup can degrade over time without basic hygiene. A few practices that help keep the system working effectively:
- Run a Weekly Review: During your status meeting, open the task report and walk through open items. This keeps the list visible and reinforces accountability without requiring additional tooling or process overhead.
- Archive Completed Pages Periodically: Once a project phase closes, archive the Confluence space or move completed pages to an archive section. This keeps the task report focused on active work and prevents the list from becoming unwieldy.
- Establish Ownership Early: Assign every action item to a specific person, not a team or role. “The development team” will never complete a task; “Sarah Chen” will. The Confluence @ mention makes individual assignment easy and sends an automatic notification to the assignee.
- Use Due Dates Consistently: A task without a due date is a wish, not an action item. Make due dates mandatory on all action items, and sort the task report by due date to create natural urgency during reviews.
- Avoid Task Sprawl: If a single page accumulates more than 20 to 25 open tasks, it’s a sign that work needs to be broken into sub-pages or that stale items need to be reviewed and closed out.
Free Project Action Item Log Template
Still tracking actions outside Confluence, or planning your labels first? This Excel log flags overdue items, counts open actions per owner and includes a Confluence label column for the move. Free, no sign-up.
Facts worth checking about Confluence tasks
Many Confluence guides, including the first version of this one, describe older behavior. Here is what Atlassian’s documentation says today.
| Claim | Verdict | What the sources say |
|---|---|---|
| Press L to add a label to a Confluence page. | Partly true | L works in Confluence Data Center. In Confluence Cloud, use the Details panel or Ctrl + Alt + A (Ctrl + Option + A on Mac). Atlassian |
| Labels can use capital letters and spaces. | False | Labels are lower case only; a space is turned into a hyphen. Atlassian |
| The Task Report macro cannot filter by assignee. | False | It has an Assigned to field, plus Created by and Created after. Atlassian |
| One Task Report can collect tasks from several spaces. | True | Space(s) and page(s) accepts a combination of spaces and pages. Atlassian |
| A Task Report can list any number of tasks per page. | False | You choose 10, 20 or 40 tasks per page of results; the default is 20. Atlassian |
| You can add the Task Report macro with wiki markup. | False | Wiki markup is not available for this macro. Atlassian |
| The Task Report macro works in live docs. | False | Not yet. Use a page, or convert the live doc to a page. Atlassian |
| Empty action items show up in Task Reports. | False | Tasks with no text are not shown in the Task Report macro. Atlassian |
| Confluence highlights overdue action items. | True | Overdue dates turn red; dates due in the next 7 days turn orange. Atlassian |
| You can assign an action item to a whole team. | Partly true | In Confluence Cloud you can mention a team of 50 members or fewer; each member is notified. Atlassian |
Frequently Asked Questions
How do I add multiple labels to the action items list?
In this example, I created two pages in Confluence and tagged them with the labels team-meetings and steering-committee. Each page has its own set of tasks as action items. Add each label separated by a comma in the Label(s) box of the Task Report macro, and the report shows the tasks from pages with any of those labels.
Can I use the Task Report macro across multiple Confluence spaces?
Yes, and this is one of the most powerful features of the macro for program-level reporting. By default, the Task Report macro pulls tasks from the space the report page lives in, but you can add every space you need in the Space(s) and page(s) field. This is particularly useful when different project teams maintain their own dedicated Confluence spaces, when a shared services team (IT, Legal, Finance) owns action items in a separate space, or when no single space captures all the work of a cross-functional initiative. Keep in mind that users viewing the portfolio page will only see tasks from spaces they have permission to access. If a stakeholder reports missing items from their task report view, check their space permissions first; that’s almost always the root cause.
Can I filter the Task Report by a specific assignee?
Yes. The Task Report macro has an Assigned to field in both Confluence Cloud and Data Center: enter one or more people and the report shows only their tasks. For large programs with ten or more active contributors, building assignee-specific views is worth the extra setup time. It allows each team member to see only their own open items, reducing noise and improving individual accountability without requiring them to scroll through the full portfolio list. Keep the Assignee column in the main portfolio report too, so individual owners are clearly visible at a glance.
Can I assign one action item to several people?
In Confluence Cloud you can mention a team instead of a person, for teams of 50 members or fewer, and each member is notified. For clear accountability, most project managers still split shared work into one action item per owner.
Where can I see all the action items assigned to me?
Tasks assigned to you appear in the Tasks view of your Confluence profile, where you can switch between tasks assigned to you and tasks you created. For a longer history or a team view, set up a Task Report filtered on your name.
Why do completed tasks still show as open in my Task Report?
This is usually a task sync delay. Publish the original page and the report page again (no changes needed), or untick and re-tick the task. Both trigger a resync.
Does the Task Report macro work in Confluence live docs?
Not yet. Add the macro to a regular page, or convert the live doc to a page from the More actions menu. Tasks you create in live docs can still be collected by a Task Report on a page.
Final Thoughts
Confluence’s power comes from its flexibility, although some initial overhead is involved in setting up the pages. Once the labeling conventions are established and the Task Report macro is configured, the system largely runs itself, updating automatically as team members check off their items before the next review cycle. This approach is a flexible, low-overhead solution for managing meeting minutes and action items across programs of virtually any size.
For PMO leaders and program managers looking to get consistent visibility without heavy tooling investment, the Confluence Task Report macro is one of the most underrated features on the platform. Start small: build one task list, label it, and set up your first Task Report. Once you see how cleanly it aggregates across pages and spaces, you’ll wonder how you managed programs without it.
Suggested articles:
- Atlassian Confluence for Project Management
- Confluence Tutorial: Build a Project Portfolio Dashboard
- Top 10 Cons & Disadvantages of Using Confluence
Andrew Makar, DMIT, PMP, CSM is an IT director with delivery experience across projects, programs and portfolios in Digital Marketing, Automotive, Software and Financial Management industries. He is an enthusiastic leader who effectively translates project management theory into practical application. His area of interest and practice is in implementing Agile processes and SCRUM techniques to deliver better software to his customers. Find out more about Andrew on andymakar.com and please reach out and connect with Andrew on LinkedIn.