On this page, we describe what you can do on the my absences tab.
Define Absence
On the global page, you can plan your upcoming absences. No matter whether you are away for holidays, a business trip, or a long term leave, you should schedule your absences in advance in Jira to let your team members know that you are out of office.
To add a new absence, go to My Absences → Absence list and click on the Add absence button.
On the screen that opens, you can define the absence with the following information:
-
Title for absence
-
Type of absence with default options*:
-
Business trip
-
Training
-
Holiday
-
Sickness
-
Conference
-
Trade fair participation
-
Long term leave
-
Other
-
-
All day toggle — enabled by default, so the absence covers the entire selected date range. Turn it off to set a start and end time for the absence, useful for half-day absences or absences that only cover part of a day.
-
Start date of absence time (Time field if all day toggle above is disabled)
-
End date of absence time (Time field if all day toggle above is disabled)
-
Message for other users (Absence notice)
* The available absence types might be different in your instance. They can be configured by system admins based on specific needs for your company.
Display and edit absences
The absence list under my absences shows your defined absences. By clicking on the edit button, you can edit them inline in case something needs to be modified. If you want to delete an entry, just click on the trash icon.
After clicking on the edit icon, the respective row in the list will switch to edit mode, and you can modify the data. If something is changed, a check icon appears to save the changes. By clicking on the close icon, you can discard your changes at any time.
You will get a notification on successful saving when you finished your modifications.
Automation and alternate settings
On the second tab under my absences, you define how the app handles your issues while you are away: which out-of-office comments are added, and which colleagues replace you in which fields.
Comment on mention
If you set this option, the app adds an out-of-office comment to an issue when you are mentioned in its description or in a comment during your absence.
Replacement fields
In the replacement fields table, you decide in which fields the app replaces you during your absence and who takes over in each of them. This way, different colleagues can cover different responsibilities, for example a technical deputy as Assignee and your team lead as Approver.
Add a row for each field in which you want to be replaced. Each row has the following columns:
|
Column |
Description |
|---|---|
|
Field |
The field in which you are replaced. You can choose the Assignee field and all user custom fields that your Jira administrator has enabled for absence replacement. Each field can only be added once. |
|
Replace |
Enable if you want to be replaced by the defined alternate user in that field during your absence |
|
Alternate |
The user who replaces you in this field during your absence. |
|
Add comment |
If enabled, the app adds a comment to the issue when it replaces you in this field. The comment names the field and the alternate user. For fields other than Assignee, this toggle is off by default. |
To stop being replaced in a field, remove its row. A row can only be saved when both a field and an alternate are selected.
Add comment on assignment: If you set this option for the assignee field, items will be automatically commented with an out-of-office notification when you are set as assignee. The comment is created by the app and will look like this:
Your Jira administrator can preset default values for both options (see default comment settings). You can still change them for yourself at any time.
What happens during your absence
-
While your absence is active, the app replaces you in each field of the table with the alternate defined for that field and the replace toggle enabled, for example on newly created issues or when you are set in one of these fields.
-
Fields that are not in the table are not changed.
-
A comment is only added for fields where Add comment is enabled. Editing an absence without changing the replacement does not create duplicate comments.
If you had defined a single alternate user before the replacement fields table was introduced, your setting has been taken over into the table. No settings were lost.
Please note that alternate users for the Assignee field need to have the assignable user permission in all projects where you get issues assigned during your absence. For user custom fields, the alternate must be a user that can be selected in that field. Otherwise, the automated replacement by the app won't work.
Please don't forget to save your settings via the save button when you change anything here. Otherwise your changes will be lost.