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, feature toggles).
• Capacity — capacity scheme management (define work schedules per user or team).
• Holidays — holiday calendar management (create calendars, assign to teams or users).
• Leave Settings — leave type configuration and leave approver assignments.
• Permissions — user access control (manage access, restrict users, app admins).
• Timesheet Access — timesheet approver and viewer rules.

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.

Feature Toggles

Enable or disable optional features across the app:

• Timesheets — enable the timesheet submission and approval workflow.
• Leave Management — enable the leave request and approval features.

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 leave type definitions and leave approver assignments. These settings determine what types of leave users can request and who approves those requests.

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").

You can create, edit, and delete leave types. The default set includes Vacation, Sick Leave, Personal, and Parental.

Leave Approvers

Assign a leave approver for each user. When a user submits a leave request, it is routed to their designated approver for review. Each user can have one assigned leave approver. If no approver is assigned, only Jira site administrators and App Admins can approve the request.

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 three sub-tabs:

Manage Access

Toggle access for all users in your Jira site. When the "All Users" toggle is enabled, every Jira user can access WorkHub. When disabled, only users explicitly added in the other sub-tabs have access.

Restrict Users

Block specific users from accessing WorkHub, even when the "All Users" toggle is enabled. Search for users by name using the user picker (supports 10,000+ users with debounced search) and add them to the restricted list. Restricted users see an "Access Denied" message when they open the app.

App Admins

Promote users to the App Admin role, granting them full access to all features and settings within WorkHub. Search for users by name and add them to the admin list. App Admins can manage settings, approve timesheets and leave, and access all configuration tabs. They cannot promote other users to App Admin — only Jira site administrators can do that.

Timesheet Access Back to top

The Timesheet Access tab controls who can approve and view timesheets. It is organized into approver rules and viewer rules, with per-user assignment support.

Approver Rules

Define who can approve timesheet submissions. Two rule types are available:

• Per-User — assign a specific approver for each team member. When the team member submits a timesheet, only their designated approver (and Jira site administrators) can approve or reject it.
• All Users — any user with the approver role can approve any team member's timesheet.

Viewer Rules

Define who can view (but not approve) other users' timesheets. Viewer rules follow the same per-user and all-users pattern as approver rules.

Per-User Assignments

The per-user assignments tab provides a table where you can assign specific approvers and viewers for each team member. Use the user picker to search and select users. Jira site administrators always have approval rights regardless of these assignments.

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.