Home

›

Planner

›

Placeholders

Planner feature

Placeholders: Plan Jira Work Before the Issues Exist

Hold people's time for a project that isn't signed, a phase that starts next quarter, or a role you haven't hired yet. Placeholders count in workload and forecasts like real work, while Jira stays as it is. Approve them when the work is confirmed and they become Jira issues.

30-day free trial on the Atlassian Marketplace. No credit card needed.

Sample ActivityTimeline Planner week in four steps. 1: a placeholder holds Priya Nair's time for the Jira issue PORT-12 Front end, Wednesday to Friday. 2: its 24 hours count in her workload, 8 of 8 hours a day. 3: in Jira, PORT-12 stays unassigned with no dates. 4: after Approve, PORT-12 is assigned to Priya and scheduled 13 to 15 January 2027.

What Is a Placeholder in ActivityTimeline?

A placeholder is a planning item in ActivityTimeline's Planner that holds a person's time for tentative work. It has one total estimate for its whole duration, counts in workload and capacity forecasts, and changes nothing in Jira until you approve it. Approval turns it into a Jira issue assigned to that person.

Time: One total estimate for the whole period, such as 24h over three days.

Workload: Counts in the person's workload and in capacity forecasts, like a Jira issue.

Jira: Unchanged while you plan. Assignee and dates change only on approval.

Link: Standalone, or linked to an existing Jira issue. One issue can have several.

Approval: One click on the card, or many at once with Bulk Reschedule.

Who approves: Team Leads, Managers and Administrators, depending on the role.

What You Can Do with Placeholders

Plan the work you expect, see what it does to your people, and make it real in Jira when it's confirmed.

Count them in workload and forecasts

Placeholders add their hours to the Resource Utilization Forecast, Team Capacity Chart and Team Utilization Forecast. Switch them off to compare the confirmed plan with the tentative one.

Count them in workload and forecasts (sample screen)

Plan an existing Jira issue

Give a Jira issue one or more placeholders without touching its assignee or dates. The Issue Card shows how many it has.

Plan an existing Jira issue (sample screen)

Approve many at once

In Bulk Reschedule, select the placeholders and choose Replace Placeholder with Jira Task.

Approve many at once (sample screen)

Plan for people you haven't hired

Create a Resource for the open position and reserve its time with placeholders. When the person joins, reassign the work to them.

Plan for people you haven't hired (sample screen)

Move a whole tentative plan

When a project slips, shift, reassign or clone a set of placeholders together with Bulk Reschedule.

Keep Jira clean

Deleting a placeholder removes only the planning item. The linked Jira issue is never deleted or changed.

Control who approves

Read-only users can't create placeholders. Approving is for Team Leads, Managers and Administrators, depending on the role.

How Placeholders Work in Planner

From the first rough plan to Jira issues the team can start on, in three steps.

Step 1 · Create

Click a day on someone's timeline and choose Placeholder in the Create New Item dialog. Add a title, project and estimate, or tick Create Placeholder for existing Jira Issue.

Step 2 · Test the plan

Drag the placeholder to other dates, stretch it, or move it to another person. Workload updates as you go, and Jira stays as it is.

Step 3 · Approve

When the work is confirmed, click Approve on the placeholder's card. It becomes a Jira issue, assigned and scheduled on its dates.

Sample Create New Item dialog with Placeholder selected: title, project, assignee, estimate, external link, description, start and due dates, and the option Create Placeholder for existing Jira Issue.

Tip: hold Ctrl (Cmd on a Mac) while you drag a Jira issue from the Issues panel onto a person to create a placeholder for it.

Placeholder setup in the Help Center

When to Use Placeholders

Placeholders are for demand you expect but can't commit to Jira yet. These are the situations PMOs, delivery leads and resource managers plan with them most.

A project waiting for sign-off

Hold the people for a client deal or budget request now, and check that the plan fits before anyone says yes.

Next quarter's roadmap

Put future phases on the timeline to see which teams run out of capacity, and when.

Roles you haven't filled

Plan an open position or a contractor as a Resource, then reassign the work when the person starts.

Deciding who takes the work

Put the same work on two or three people, compare their workload, and keep the option that fits.

Specialists several projects want

When the architect's next month is held, other managers see that time is taken before they plan on it.

A Jira issue that isn't ready to assign

Plan one issue across several people or periods with more than one placeholder, then pick the final assignee.

Placeholder, Booking or Jira Issue: Which One to Use?

All three put work on a person's timeline and count in their workload. They differ in how certain the work is and in what they do to Jira.

Placeholder, Booking and Jira issue compared in ActivityTimeline Planner
QuestionPlaceholderBookingJira issue
Use it forTentative work: unsigned projects, future phases, what-if plansReserving a share of someone's time, such as 4 hours a day or 50%Confirmed work that already exists in Jira
How time is setOne total estimate for the whole periodHours per dayRemaining estimate, daily estimate or story points
Changes JiraOnly when you approve itNoYes. Scheduling sets the assignee and dates
Counts in workload and forecastsYesYesYes
Can become a Jira issueYes, when approvedNoIt already is one

Planning for someone who isn't in Jira yet? Add a Resource for the open position or contractor and plan placeholders on its timeline. When the person joins, reassign the work to them.

Questions About Placeholders

Answers about planning tentative work in ActivityTimeline.

Still have a question?

Contact us through the support portal
Does a placeholder change anything in Jira?
No. While you plan, a placeholder lives only in ActivityTimeline. You can change its dates, estimate or person, and the linked Jira issue stays as it is. Jira changes only when you approve the placeholder, and deleting a placeholder never deletes or edits a Jira issue.
What is the difference between a placeholder and a booking?
A placeholder has one total estimate spread over its dates and stands in for tentative work that can become a Jira issue. A booking reserves a set number of hours per day for a project or activity and stays a booking. Use placeholders for work you may do, and bookings for time you set aside.
Do placeholders count in workload and capacity reports?
Yes. A placeholder adds its hours to the person's workload indicator in Planner. The Team Capacity Chart, Resource Utilization Forecast and Team Utilization Forecast include placeholders, and you can switch them off in each report's data sources to compare the confirmed plan with the tentative one.
Can one Jira issue have several placeholders?
Yes. Link several placeholders to one Jira issue to plan it across different people, teams or periods before you choose the final assignee. Turn on Issue Placeholder Icon in Configuration, Issues, to see the count on the issue bar.
Can we plan for people we haven't hired yet?
Yes. Create a Resource in ActivityTimeline for the open position, with its position, skills and capacity, and reserve its time with placeholders. Jira issues can't be assigned to a Resource, so when the new person joins, reassign the planned work to them.
Can I approve many placeholders at once?
Yes. Open Bulk Reschedule from the Issues panel (Extra, then Bulk Reschedule) or from a person's card, select the placeholders and choose Replace Placeholder with Jira Task or Approve All. The same tool moves, reassigns or clones a set of placeholders when a project slips.
Who can create and approve placeholders?
People can create placeholders for themselves or for others, depending on their ActivityTimeline role. Read-only users can't create or change them. Approving is for roles with that permission, such as Team Leads, Managers and Administrators.

Plan Your Next Project Before It Reaches Jira

Start a 30-day free trial on your own Jira projects and add your first placeholder, or see it in a 25-minute live demo with a product specialist.

30-day free trial on the Atlassian Marketplace. No credit card needed.