If you have not installed WorkHub yet, grab it from the Atlassian Marketplace. Once installed, the app is available from the Apps menu in your Jira site.
Accessing the App Back to top
WorkHub is a Forge app for Jira Cloud, accessible from the Apps menu in your Jira navigation bar. It provides a full-screen application with a sidebar for navigating between modules.
The app contains seven modules:
- Scheduler — Gantt-like resource planning across all your Jira projects
- Time Tracking — log worklogs against any Jira issue
- Timesheets — submit and approve weekly timesheets
- Leave — request and approve time off
- Reports — utilization, worklog, leave, and planned-vs-actual reports
- Settings — field mapping, capacity schemes, holidays, permissions (admin only)
- My Account — personal preferences and assigned schemes
Field Mapping Back to top
On first launch, a Field Setup Dialog asks you to configure which Jira fields represent the start and end dates for your issues. This is the only required configuration — the app uses Jira's native Assignee, Status, and Original Estimate fields automatically.
The two field mappings are:
| Field | Jira Field Type | Purpose |
|---|---|---|
| Start Date | Date field | Determines where an issue begins on the scheduler timeline. Can be any Jira date field (e.g., built-in Start Date, or a custom date field). |
| End Date | Date field | Determines where an issue ends on the scheduler timeline. Typically the Due Date field, but any date field works. |
The setup dialog pre-selects the most common date fields (Start Date and Due Date) if they exist on your Jira site. You can change these at any time in Settings › Field Mapping.
Automatically detected fields
WorkHub reads these Jira fields without explicit mapping:
- Assignee — determines who is responsible for each issue. The scheduler organizes issues by person.
- Status — used for color-coding issue cards (To Do, In Progress, Done) and filtering completed issues.
- Original Estimate — Jira's built-in time estimate field (
timeoriginalestimate). Used for workload calculations and capacity planning. - Remaining Estimate — Jira's remaining estimate field (
timeestimate). Jira auto-populates this from Original Estimate and decrements as work is logged.
Issues in Jira Back to top
WorkHub works with all standard Jira issue types — Stories, Tasks, Bugs, Epics, and any custom issue types you have configured. The scheduler displays issues from your Jira projects based on the configured field mapping.
- Parent issues and subtasks — both appear on the scheduler timeline. Subtasks are shown alongside parent issues.
- Epics — can be scheduled like any other issue if they have start and end dates.
- Custom allocations — in addition to Jira issues, you can create manual allocation entries (e.g., "Training", "Meetings") that are not linked to specific Jira issues but still contribute to workload calculations.
The scheduler pulls issues from all Jira projects you have access to. Use the project and status filters in the toolbar to narrow what is displayed.
Scheduler Overview Back to top
The resource scheduler is a Gantt-like timeline where each row represents a team member and issue cards are positioned by their start and end dates.
View modes
Five zoom levels let you see the right time horizon:
- Week — seven days with day columns (default)
- 2-Week — fourteen days with day columns
- Month — one calendar month with day columns
- Year (monthly) — twelve months with month columns
- Year (daily) — twelve months with day-level granularity
Key features
- Drag-and-drop — drag issues horizontally to reschedule, vertically to reassign, or resize to change duration.
- Custom allocations — create manual bookings alongside Jira issues for non-issue work.
- Leave & holiday display — approved leave and holidays appear as colored blocks on the scheduler.
- Workload indicators — toggle the workload overlay to see real-time capacity per person per day.
- Create issues — right-click or double-click to create new Jira issues directly from the scheduler.
- Context menu — right-click for quick actions like scheduling an issue or logging time.
For full details, see Resource Scheduler.
Capacity & Workload Basics Back to top
Workload calculation brings together three data sources to show whether your team is balanced or overloaded:
- Capacity schemes define how many hours each person works per day (default: 8 h/day, Mon–Fri). See Capacity Schemes.
- Holiday calendars reduce available hours on public holidays. See Holiday Calendars.
- Leave is approved time off that further reduces available hours. See Leave Management.
The workload overlay offers three indicator modes, each showing a different perspective on your team's load. The default Remaining Estimate mode distributes remaining hours across future working days, giving you a forward-looking view of planned workload. See Workload Management for details.
Color-coded indicators
Green means healthy utilization (51–100%). Yellow means near capacity (101–120%). Red means overloaded (>120%). Light blue means underloaded (0–50%). At a glance, you can see where to redistribute work.
What's Next Back to top
Now that you understand the core concepts, explore the features in detail:
- Resource Scheduler — Gantt-like timeline with drag-and-drop, view modes, and custom allocations.
- Workload Management — Color-coded capacity indicators and five workload modes.
- Time Tracking — Log work hours against Jira issues with weekly grid view.
- Timesheets — Submit weekly timesheets for approval and manage the approval workflow.
- Leave Management — Request and approve time off, with leave reflected in capacity calculations.
- Reports — Generate utilization, worklog, leave, and planned-vs-actual reports.
Email support@reinwok.com for assistance.
Need Help?
If you have questions or need assistance with WorkHub for Jira, our support team is here to help.
Contact Support