Home

›

Timesheets

›

Timesheet Approval

Timesheets feature

Timesheet Approval in Jira: Review, Approve and Lock Worklogs

Payroll and client invoices should only use time someone has checked. ActivityTimeline's Timesheets module lets managers and team leads review Jira worklogs, approve them one by one or in bulk, and lock approved time so it can't change after the review.

30-day free trial on the Atlassian Marketplace.

1

See what still needs review

Filter last week by Pending Approval: 8 worklogs, 31 hours, four people.

2

Check one worklog

Open Record Details, read the description, category and client, then approve.

3

Approve the rest in bulk

Tick the six you've checked. Ryan's entry has no description, so it waits.

4

Confirm approval progress

Approval Progress shows 146 of 150 hours approved. Only Ryan's 4 hours are left.

What Is Timesheet Approval in ActivityTimeline?

Timesheet approval in ActivityTimeline is an optional review step for Jira worklogs. When an administrator turns it on, every worklog starts as Pending Approval. An Administrator, Manager, Power Team Lead or Team Lead reviews it in Timesheets and approves it, and the approved worklog is locked until someone with approval rights unapproves it. It is part of the Timesheets module of ActivityTimeline, the resource planning, capacity management and time tracking app for Jira.

Worklog statuses

Pending Approval, Approved, Closed Approved and Closed Rejected.

Approval Progress

Shows approved hours next to logged hours for each person or team.

Period closure

Optional weekly or monthly periods, with a grace period of up to 30 days.

Edits made in Jira

Approved records keep their values unless you choose to update them.

What Can You Do with Timesheet Approval in ActivityTimeline?

Review a period's worklogs, approve what you've checked, and keep approved time from changing behind your back.

Approve a team's week in one pass

Set the team, period and filters in the Detailed View, tick the worklogs you've checked and approve them together. Anything unclear stays in Pending Approval.

Sample bulk approval: four pending worklogs, two selected, one Approve button.

See who still has time to review

The Approval Progress template puts approved hours next to logged hours for each person or team, so you chase the gaps instead of opening every worklog.

Sample Approval Progress for three teams on Monday morning and Monday evening.

Lock approved time

An approved worklog can't be edited. If it needs a fix, an approver unapproves it, the person corrects it, and it comes back for review.

Sample approved worklog seen by the person who logged it and by an approver.

Close the period after review

Choose a weekly or monthly reporting period and a grace period from none up to +30 days. During the grace period people can still log and fix last period's time. When it ends, the period closes: nobody can add, edit or delete its worklogs, approved ones become Closed Approved, and anything still pending becomes Closed Rejected.

Sample monthly period with a +3 days, 12:00 grace period: November closes on Dec 3 at 12:00.

See who approved what

Add the Approval Status and Approver columns to the Detailed Timesheet, then filter or sort by them when finance or a client asks.

Approvers follow your teams

Which worklogs an approver sees depends on their ActivityTimeline role and permissions. A Team Lead, for example, may only review their own teams.

Keep the approved record when Jira changes

The setting Update approved worklogs if changed in Jira is off by default, so a later edit in Jira does not change the record you approved. Turn it on if approved records should follow Jira.

How to Approve Timesheets in Jira with ActivityTimeline

Three steps. An administrator turns approval on once; after that, approvers review each period in Timesheets.

Step 1 · Turn on approval

Go to Configuration › Timesheets Configuration › Timesheet Approval Settings and enable Approval Workflow in Timesheets. Give each approver the Administrator, Manager, Power Team Lead or Team Lead role.

Step 2 · Review the period

Open Timesheets, set the team and period, and filter by approval status. The Detailed View lists every worklog; click one to open Record Details.

Step 3 · Approve and lock

Approve worklogs one by one or in bulk, then check Progress › Approval Progress. With period closure on, the period locks when the grace period ends.

Sample Timesheet Approval Settings: Approval Workflow in Timesheets, Update approved worklogs if changed in Jira, Time Tracking Period Closure, Time Tracking Period (Monthly or Weekly) and Time Logging Grace Period, with what each choice changes for the team.

Tip: before you approve in bulk, check the scope, period and filters, so only the worklogs you reviewed are included.

Timesheet Approval Settings in the Help Center

When Do Teams Use Timesheet Approval?

Six moments when someone has to sign off on the time logged in Jira.

Contractor pay and payroll

Contractors are paid by the hour. Approve the month's worklogs before the payroll export, so the hours paid are the hours a manager checked.

Client invoices

An agency bills time and materials. Approve billable worklogs before the invoice run and lock them, so the invoice and the timesheet still match next month.

Month-end close

Finance closes the month on the 3rd. A monthly period with a +3 days grace period gives people time to fix gaps, then locks the month.

Weekly team lead review

Every Monday, team leads approve last week's worklogs for their own teams, filtered to Pending Approval.

Audits and client questions

Someone asks who signed off 40 hours on a client project in March. The Approver column in the Detailed Timesheet answers it.

Many approvers across a large unit

A 300-person delivery unit splits review across its team leads. Approval Progress shows which teams are done and which still have hours to review.

Timesheet Approval vs Period Closure: What's the Difference?

Approval confirms that someone checked a worklog. Period closure decides whether a period can still change. Teams that bill or pay from Jira time usually use both.

Timesheet approval

Confirms that someone checked a worklog.

Question it answers: Has someone checked this worklog?

Who acts: An approver, per worklog or in bulk.

Applies to: One worklog at a time.

What it locks: Edits to the approved worklog. New worklogs for the period are still allowed.

Undo: An approver can unapprove while the period is open.

Covers: Worklogs in Timesheets.

Period closure

Decides whether a whole period can still change.

Question it answers: Can this period still change?

Who acts: No one. The period closes by itself when its grace period ends.

Applies to: Every worklog dated in the period.

What it locks: Adding, editing and deleting worklogs for the period.

Undo: Statuses become Closed Approved or Closed Rejected.

Covers: Jira issue worklogs only.

Good to know: there is no Reject button, so leave a worklog in Pending Approval and ask the person to fix it. Pending worklogs are not approved when a period closes; they become Closed Rejected. Period closure works only with Jira issue worklogs and switches off Treat Booking Items as Worklogs and treating external calendar events as worklogs. For full protection, set ActivityTimeline as Jira's time tracking provider: it can't stop a worklog from being changed directly in Jira or in another app.

Timesheet Approval FAQ

What managers and Jira admins ask before they switch approval on.

Still have a question?

Contact us through the support portal
Does Jira have built-in timesheet approval?
No. Jira records worklogs on issues but has no approval status for them, and Atlassian lists worklog approval as a feature request. Teams add an app such as ActivityTimeline, where approvers review and approve worklogs in the Timesheets module.
Who can approve worklogs in ActivityTimeline?
Users with the Administrator, Manager, Power Team Lead or Team Lead role, once an administrator turns on the approval workflow. Which worklogs each approver sees depends on their role and team access. A Team Lead, for example, may only review the worklogs of their own teams.
How do I reject a worklog?
There is no separate Reject action. Leave the worklog in Pending Approval and ask the person to correct it. If period closure is on, a worklog that is still pending when the period closes becomes Closed Rejected and can no longer be changed.
Can I change an approved worklog?
Not directly. An approved worklog is locked. While the reporting period is open, a user with approval rights can unapprove it, the person makes the change, and the worklog is approved again.
Can I approve many worklogs at once?
Yes. Set the scope, period and filters in a Timesheets view, select the worklogs and approve them in bulk. Check the filters first, so only the worklogs you reviewed are included.
What happens to pending worklogs when the period closes?
They are not approved automatically. They become Closed Rejected and are locked, so review outstanding worklogs before the grace period ends.
How do I see which timesheets still need review?
Open Timesheets, go to the Progress view and choose the Approval Progress template. It shows approved hours against logged hours for each person or team. The template appears only when the approval workflow is on.
Do edits made in Jira change an approved worklog?
Only if you allow it. With Update approved worklogs if changed in Jira turned off, which is the default, ActivityTimeline keeps the approved record when someone edits the worklog in Jira. Turned on, the approved record follows the Jira change.

Approve Your Team's Jira Time Before the Next Payroll

Try timesheet approval on your own Jira worklogs for 30 days, or see it with your team in a 25-minute demo.

30-day free trial on the Atlassian Marketplace.