Settings & Configuration

Overview Back to top

The Settings view is accessible to Jira site administrators and App Admins. It provides a centralized configuration panel organized into six tabs:

• General — app-wide defaults (work hours, work days).
• Teams — create/edit/update teams.
• Permissions — user access control (manage access, create team managers, app admins).
• Leave Settings — leave type configuration and leave approver assignments.
• Timesheet Settings — timesheet approval configuration.
• Capacity — capacity scheme management (define work schedules per user or team).
• Holidays — holiday calendar management (create calendars, assign to teams or users).
• Allocations — create and manage allocations categories.
• Issue Display — custom color rules for Scheduler issue bars (priority, status, fix versions, custom fields, due dates). See Issue Colors for full documentation.

General Back to top

The General tab contains app-wide settings that affect all users and features.

Work Hours per Day

Set the default number of working hours per day (e.g., 8 hours). This value is used as the baseline for capacity calculations, workload indicators, and utilization reports. Individual capacity schemes can override this per user.

Work Days per Week

Select which days of the week are working days (Monday through Sunday). Non-working days are excluded from workload calculations and highlighted on the scheduler timeline. The default is Monday through Friday.

Field Mapping Back to top

Field Mapping configures which Jira custom fields represent the Start Date and End Date for issues on the scheduler timeline. Without this mapping, WorkHub cannot determine where to place issues on the timeline.

First-Run Setup

The first time the plugin is opened, a Field Setup Dialog is displayed automatically. It guides the administrator to select the appropriate Jira fields for start and end dates. Sensible defaults are pre-selected based on commonly used field names.

Updating Field Mapping Later

After initial setup, field mapping can be changed at any time from Settings → General or by accessing the Field Mapping configuration directly. The dropdown lists all date-type custom fields available in your Jira instance.

Capacity Back to top

The Capacity tab lets you create and manage capacity schemes — named work schedules that define how many hours each person works per day of the week. Capacity schemes are assigned to individual users or teams, allowing different schedules for full-time, part-time, or compressed work weeks.

• Standard Full-Time — 8 hours/day, Monday through Friday.
• Part-Time — 4 hours/day, Monday through Friday.
• Compressed Week — 10 hours/day Monday through Thursday, off Friday.
• Custom schemes — create any combination of hours per weekday.

Capacity schemes directly affect workload indicators on the scheduler, utilization calculations in reports, and available hours in timesheet views.

Holidays Back to top

The Holidays tab lets you create and manage holiday calendars — named sets of public holidays that can be assigned to teams or individual users. When a holiday falls on a working day, it is excluded from capacity calculations, workload indicators, and report totals.

• Create calendars — define a named calendar (e.g., "US Federal Holidays 2026" or "Ukraine Public Holidays 2026").
• Add holidays — add individual holiday dates with names to a calendar.
• Assign calendars — assign calendars to teams or specific users. A user inherits holidays from their assigned calendar.

Leave Settings Back to top

The Leave Settings tab controls the leave approval workflow toggle, leave type definitions, and leave approver assignments. These settings determine whether leave requests need approval, what types of leave users can request, and who approves those requests.

Approval Workflow

Master toggle for the entire leave approval workflow. When off, every leave request is auto-approved on creation — the approver picker is hidden in the Request Leave dialog and approver assignments below are saved but not consulted. App admins or org managers can still create leave on behalf of any user, also team managers can create leave on behalf of users from team they are managing; those requests are also created in Approved status. Turn this on to require approver review (Pending → Approved/Rejected) for all new requests.

With approval off, the owner gains direct control over their own approved leaves — they can edit, recall (which goes straight to Recalled, skipping Recalling), and drag/resize the bar on the Resource Scheduler. With approval on, an approved leave is locked and the owner must request a recall through the approver. See Leave → Approval Workflow for the full state machine.

Leave Types

Manage the types of leave available to users. Each leave type has:

• Name — the display name (e.g., Vacation, Sick Leave, Personal, Parental).
• Color — the color used on the scheduler timeline and leave calendar to visually distinguish leave types.
• Abbreviation — a short code displayed in compact views (e.g., "VAC", "SL", "PER").

The list starts empty — the app does not ship with any pre-defined leave types. Admins create the types their organization needs (Vacation, Sick Leave, etc.) before users can submit requests, and can edit or delete them at any time.

Timesheet Settings Back to top

Configure the approval workflow, lock behavior, and submission periods for timesheets.

Approval Workflow

Master toggle for the entire approval workflow. When off, users cannot submit timesheets and no worklogs are locked. Turn this on to enable the submit → approve → lock cycle.

Submission Period

Frequency of timesheet submission periods. Choose Weekly or Monthly. This determines how time ranges are divided when users submit timesheets for approval.

First Day of Week

Override the week start day used for weekly submission periods. Leave as "Use Jira locale" to follow each user's Jira profile locale setting. Select a specific day (e.g., Monday or Sunday) to enforce a consistent week start for all users' timesheet periods.

Permissions Back to top

The Permissions tab controls who can access WorkHub and at what level. It is organized into six sub-tabs:

Issue Display Back to top

The Issue Display tab has three sub-tabs: Issue Color (how issue bars are painted), Issue Card (which fields show directly on the issue bar and sidebar card), and Issue Tooltip (which fields appear in the popover when you click an issue bar).

Issue Color

• Default appearance — color by Jira status category (the original behavior) or a single uniform color for every unmatched issue.
• Color rules — "when field X matches value Y, paint the bar Z." Drag the handle on each rule to set priority — the first matching rule wins.
• Supported field families — priority, status, issue type, fix versions, components, labels, custom select / multi-select / text / number / date fields, and presence checks (is empty) for user-picker fields and most other custom field kinds.

For full details, examples, the operator reference, and supported field types, see the dedicated Issue Colors page.

Issue Card

Choose which fields appear directly on the issue bar in the Scheduler and on the issue card in the plan-issue sidebar — the information you see at a glance, without clicking. (The Issue Tooltip below is different: it controls the popover that opens when you click a bar.)

• Each card has two lines, and you can place up to two fields on each. Fields on the same line appear side by side, separated by a “·”.
• Out of the box, the first line shows the issue key and the second line shows the summary. You can change either line — for example add the assignee, due date, or a custom field.
• Pick fields the same way as the tooltip: search on the right, then click +1 to add a field to the first line or +2 for the second line. Use × to remove and ↑/↓ to reorder on the left.
• Three checkboxes turn the issue-type icon, priority icon, and hours badge on or off. These always sit at the start of the first line.
• The Preview shows how a card will look as you make changes. If a field has no value on an issue, it is simply left off that card, so cards stay clean.
• Reset to defaults returns to the issue key on line 1 and the summary on line 2.

Site-wide, admin-only — the chosen layout applies to every user on the site.

Issue Tooltip

Choose which Jira fields appear in the issue-click popover on the Scheduler. The left column lists the fields you've selected, in display order. The right column lists all available Jira fields, grouped into System fields (Status, Assignee, Priority, Due date, etc.) and Custom fields (anything starting with customfield_ — Story Points, Sprint, Epic Link, organisation-specific selects, etc.). Type in the search box to filter by name or field ID.

• Click + on the right to add a field; × on the left to remove it; ↑/↓ to reorder.
• Reset to defaults repopulates the list with Status, Assignee, Priority, Due date, Time estimate, and Project — the default popover content out of the box.
• Saving an empty list is valid — the popover then shows a placeholder message with a link back to this tab.
• Field values are loaded on demand when a user clicks an issue, so adding heavy custom fields does not slow down the schedule fetch. Values are session-cached, so reopening the same issue is instant.
• The fetch respects Jira's per-field permissions — users only see field values they are allowed to view in Jira.

Site-wide, admin-only — the chosen list applies to every user on the site.

Related Pages Back to top

• Permissions & Access — detailed breakdown of user roles, approval permissions, and access control.
• Reports — generate utilization, project, leave, and worklog reports.
• Resource Scheduler — the resource scheduler affected by capacity and holiday settings.
• Getting Started — initial setup guide including field mapping.
• Issue Colors — custom color rules for the Scheduler timeline.