# 5.3 Project task cards
![logo](https://docs.tic.gal/uploads/images/gallery/2026-09/XsG3sn3UWIsBbGgu-embedded-image-pf7xwh7d.png)
*Part of the **Agile Project Management** manual — see also [1. Introduction](https://docs.tic.gal/books/agile-project-management/page/1-introduction), [2. What's New](https://docs.tic.gal/books/agile-project-management/page/2-whats-new), [3. Scope](https://docs.tic.gal/books/agile-project-management/page/3-scope), [4.1 General setup](https://docs.tic.gal/books/agile-project-management/page/41-general-setup), [4.2 Labels](https://docs.tic.gal/books/agile-project-management/page/42-labels), [4.3 Project task templates and checklists](https://docs.tic.gal/books/agile-project-management/page/43-project-task-templates-and-checklists), [4.4 Notifications](https://docs.tic.gal/books/agile-project-management/page/44-notifications), [5.1 The board](https://docs.tic.gal/books/agile-project-management/page/51-the-board), [5.2 Working with cards](https://docs.tic.gal/books/agile-project-management/page/52-working-with-cards), [5.4 Ticket cards](https://docs.tic.gal/books/agile-project-management/page/54-ticket-cards), [5.5 Labels](https://docs.tic.gal/books/agile-project-management/page/55-labels), [6. Troubleshooting](https://docs.tic.gal/books/agile-project-management/page/6-troubleshooting).* ## 5.3.1 Adding a card A new card is always a project task — ticket cards appear on the board once a ticket is linked to the project, they cannot be created directly from the board. ### 5.3.1.1 Add a card to a column Click **Add a card** at the bottom of a column (or hover over the column header and select **Add a card** from the menu), give it a title, then fill in the detail panel that opens: description, assigned user(s) or group, start and end dates, planned duration, and type. The card is created directly in that column's project state. ![Adding a card — Add a card to a column](https://docs.tic.gal/uploads/images/gallery/2026-09/ZfxQGSsy2aix63Yn-embedded-image-a1esxxji.png) ### 5.3.1.2 Add a card from a template Next to each column's **+** is a **++** button (**Add a card from template**). Click it, choose a **Project task template** and click **Add**. The number after a template's name is the size of its checklist. ![Adding a card — Add a card from a template](https://docs.tic.gal/uploads/images/gallery/2026-09/QqcAJgWRjsYgDY9E-embedded-image-b4ciejcj.png) ![Adding a card — Add a card from a template](https://docs.tic.gal/uploads/images/gallery/2026-09/rd5JdFCiiWbWbo4z-embedded-image-9t7rrghq.png) ### 5.3.1.3 Review the card filled from the template The new card opens filled in from the template: name, description, type, planned duration, dates and percent done. Everything stays editable. The template's checklist is copied to the task when you click **Save**. ![Adding a card — Review the card filled from the template](https://docs.tic.gal/uploads/images/gallery/2026-09/au971YubpKaDoeok-embedded-image-tcmjbfvv.png) > **Note:** Adding a card requires the **Add a card** right. Neither button is shown in a column for a finished state, or when no project task template exists (for **++**). ## 5.3.2 Editing a task card The detail modal for a task card contains several fields for entering and editing information. ### 5.3.2.1 Open a task card Task cards are fully editable — you can change the title, description, assigned users, dates, duration, type and all other fields (depending on your permissions). Edit any field by clicking on it and making your changes. ![Editing a task card — Open a task card](https://docs.tic.gal/uploads/images/gallery/2026-09/tTjtogDAxTbH9ahW-embedded-image-nq2p5yor.png) ### 5.3.2.2 Edit the title Open the card and click on the **Name** field to edit it. A red asterisk marks required fields. ![Editing a task card — Edit the title](https://docs.tic.gal/uploads/images/gallery/2026-09/EzSCWuO9sfx6JH6K-embedded-image-6z8o3uvx.png) ### 5.3.2.3 Edit the description Click the **Description** field to edit the card's description. Each is a separate right (**Edit title**, **Edit description**), so a profile can allow one without the other. ### 5.3.2.4 Assign a user Use the **User** field in the card detail panel to add or remove team members. This is gated by the **Assign user to a card** right. ![Editing a task card — Assign a user](https://docs.tic.gal/uploads/images/gallery/2026-09/2YMYU9DMh1RVTo0i-embedded-image-9lgxbdp7.png) ### 5.3.2.5 Set start and end dates Use the **Planned start date** and **Planned end date** fields to set the card's timeline. Everyone can see them; changing them needs the **Edit planned dates** right. ### 5.3.2.6 Set planned duration Use the **Planned duration** dropdown to estimate how long the task will take. ### 5.3.2.7 Set the card type Use the **Type** dropdown to categorize the task (e.g., Bug, Feature, Documentation). Available types are configured in Setup. ### 5.3.2.8 Attach a file In the **Files** section of the modal, click the upload area or drag and drop a file to attach it to the card. Files attached to a card trigger the **New Attachment** notification and become regular GLPI documents linked to the underlying project task. ![Editing a task card — Attach a file](https://docs.tic.gal/uploads/images/gallery/2026-09/Zll4oWC82PuQuIev-embedded-image-stb3czjn.png) > **Note:** Editing permissions are granular — each field is gated by its own right. A read-only field is grayed out and cannot be edited. ## 5.3.3 Reading a task card A task card shows the task's type, time, dates, progress, checklist and linked tickets at a glance. Hover any icon for a tooltip. ### 5.3.3.1 Task card layout A project task card shows: - The card's title (the task name) - Assigned user avatars (overlapping icons at the bottom) - Type badge showing the task type (*Development*, *Support*, *New Feature*, *Spike*) - Duration icon and duration estimate - Creation date with date icon - Progress bar showing percent done - Comment and attachment counts at the bottom ![Reading a task card — Task card layout](https://docs.tic.gal/uploads/images/gallery/2026-09/l7ffMDwsRWB92adC-embedded-image-djdfsfja.png) ### 5.3.3.2 Task type icon A tag icon and label show the task's **Type**, one of the project task types defined under **Setup → Dropdowns → Project task types**, and set in the task's **Type** field. A task with no type shows neither the tag nor the planned duration next to it. Hover the tag to see the full type name when it is shortened. Ticket cards show their ticket type (Incident or Request) as an icon instead. In this example the types are *Development*, *Support*, *New Feature* and *Spike*. ![Reading a task card — Task type icon](https://docs.tic.gal/uploads/images/gallery/2026-09/l1s4QfwIhJjS1F7d-embedded-image-75rqy4bu.png) ### 5.3.3.3 Planned duration A task's planned duration is the first figure of the card's time row, after a clock icon; the hours spent and the variance follow it, in hours and as a percentage, green while there is time left and red once over (see *Time on a task*). A task with no planned duration shows only the hours spent. ![Reading a task card — Planned duration](https://docs.tic.gal/uploads/images/gallery/2026-09/H7udYBAAkPbeNSBg-embedded-image-qpgwespy.png) ### 5.3.3.4 Dates and their colour A calendar icon shows the task's planned dates, in days only; a range within one month shows the month once. Hover it for the full dates. Without planned dates the card shows its creation date. The date's colour tells how close the task is to its planned end, using the same colours and thresholds as a ticket's Time to resolve: - **Grey**: no planned end, or the task hasn't started and its planned start is still ahead. - **Green**: on time; or finished on or before its planned end. - **Amber**: the planned end is approaching. - **Red**: the planned end is close (critical). - **Black**: overdue; past its planned end, or finished after it. ![Reading a task card — Dates and their colour](https://docs.tic.gal/uploads/images/gallery/2026-09/sSdSWltKKFtnjRVH-embedded-image-vmzfl0cl.png) ### 5.3.3.5 Progress bar A coloured bar shows how much of the task is complete (percent done, 0–100%). When a task is 100% complete, the bar turns green and the percentage is hidden. Percent done is either typed in the task, or calculated automatically from the task's solved or closed tickets and its done checklist items, when **Calculate task progress from tickets and checklist** is on (see [4.1.2 Configuration](https://docs.tic.gal/books/agile-project-management/page/41-general-setup)). ![Reading a task card — Progress bar](https://docs.tic.gal/uploads/images/gallery/2026-09/s3mFoQac9OKBhnjV-embedded-image-ewoy7jmo.png) ### 5.3.3.6 Attachments icon A paperclip icon shows how many files are attached to the card. Click it (if the modal is open) to jump to the attachments section. ![Reading a task card — Attachments icon](https://docs.tic.gal/uploads/images/gallery/2026-09/s6rCo5EI8EVuYTje-embedded-image-u17diikp.png) ### 5.3.3.7 Checklist icon A checkmark icon indicates the card has a checklist. Click it (if the modal is open) to show/hide the checklist panel. ![Reading a task card — Checklist icon](https://docs.tic.gal/uploads/images/gallery/2026-09/NUGNmacw5vbFFw2m-embedded-image-6fbjdywr.png) ### 5.3.3.8 Linked tickets ring A task card with tickets linked to it shows a ring with a ticket icon and a count such as *1/3*: tickets solved or closed, out of all the tickets linked to the task. The ring fills as tickets are solved and turns green when all are. Until then it takes the worst Time to resolve colour of its tickets, so a late ticket shows on the task too. Hover it for the details; the tickets themselves are listed in the task's card window (see *Tickets linked to a task*). ![Reading a task card — Linked tickets ring](https://docs.tic.gal/uploads/images/gallery/2026-09/NouaT5l8CNYkjKME-embedded-image-vaikrnnc.png) ## 5.3.4 Time on a task: hours, real dates and late tasks Each task card compares the time planned for the task with the time actually spent on it, and the board records when work on the task really started and ended. Both are kept up to date from the board itself, so the team does not have to fill them in. ### 5.3.4.1 Read the hours on a card A task card with a planned duration shows three figures in its time row: - **Planned** (clock) — the task's **Planned duration**. - **Spent** (clock with a play sign, or a stop sign once the task is finished) — the task's **Effective duration** plus the time logged on the tickets linked to it. Hover it to see the breakdown. Once it goes over the planned duration it turns into a red badge, so an over-budget task stands out on the board. - **Left or over** (delta) — planned minus spent, as a percentage of the plan. Green is time left; red, with a minus sign, is time over the plan. A task with no planned duration shows only the hours spent. ![A task over its plan: 24 h planned, 26 h spent, 8 % over](https://docs.tic.gal/uploads/images/gallery/2026-09/WDyetM8gfb5XOhta-embedded-image-nj2rymtq.png) *A task over its plan: 24 h planned, 26 h spent, 8 % over* ### 5.3.4.2 Hours and real dates in the card window The card window repeats the planned and spent hours next to the task number, with the time left or over in hours and percent, and shows the time fields in its side panel: - **Real start date** and **Real end date** — when work on the task really started and ended (see the next step). - **Effective duration (h)** — the time spent on the task itself. - **Tickets duration (h)** — the time logged on the tickets linked to the task, read-only here because it comes from the tickets. ![Time on a task: hours, real dates and late tasks — Hours and real dates in the card window](https://docs.tic.gal/uploads/images/gallery/2026-09/XGmuXlVKVNqIejVc-embedded-image-xcfi2pjb.png) ### 5.3.4.3 How the board fills in the real dates Moving a task on the board fills in its real dates: - Leaving the first column (or the **No status** column) sets the **Real start date**, if it is still empty. - Reaching a column whose project state is flagged **Finished** sets the **Real end date** (and the start date, if the task skipped straight there). - Moving a task back out of a finished column clears its end date and keeps its start date. A user with the **Edit real dates** right can correct either date by hand in the card window; for everyone else the two fields are read-only. ### 5.3.4.4 Show only late tasks Click the **Late** icon (a clock with an exclamation mark) in the toolbar to keep only the tasks whose time spent is over their planned duration. Click it again to show every card. ![With Late on, only the two tasks over their planned hours remain](https://docs.tic.gal/uploads/images/gallery/2026-09/Dkm3mFkpxX14WR2P-embedded-image-hbs7pwyp.png) *With Late on, only the two tasks over their planned hours remain* ## 5.3.5 Checklists on task cards Project task cards can have a checklist — a list of subtasks that you can check off as you complete them. Checklists are task-specific: ticket cards do not have one. ### 5.3.5.1 Show/hide the checklist Open a task card. If it has a checklist, a checkmark icon appears in the action bar at the top. Click it to toggle the checklist panel visible/hidden. The checklist appears below the description in the modal. ![Checklists on task cards — Show/hide the checklist](https://docs.tic.gal/uploads/images/gallery/2026-09/Yq3It9uHSZntK5jS-embedded-image-si175yxh.png) ### 5.3.5.2 Check off a checklist item In the checklist panel, click the checkbox next to an item to mark it complete. Completed items get a strikethrough and are slightly grayed out. ![Checklists on task cards — Check off a checklist item](https://docs.tic.gal/uploads/images/gallery/2026-09/TgQRGo2LSoMnPdlp-embedded-image-jflxfazc.png) ### 5.3.5.3 Add a checklist item At the bottom of the checklist, type a new item name in the **Add an item** text box and click **Add**, or press Enter. The new item appears in the list, unchecked. ![Checklists on task cards — Add a checklist item](https://docs.tic.gal/uploads/images/gallery/2026-09/LxrwAUI81dnXg5G5-embedded-image-2nhwmx6b.png) ### 5.3.5.4 Edit a checklist item Hover over a checklist item and click its text to edit it in place, then press Enter to save the change. ### 5.3.5.5 Delete a checklist item Hover over a checklist item and an X icon appears on the right. Click it to remove the item from the checklist. > **Note:** Checklist permissions follow the card edit permissions — if you can edit the task, you can edit its checklist. > **Note:** A checklist progress ring appears on the card front (in the footer) showing the percentage of items checked. The ring fills as you complete items. ## 5.3.6 Tickets linked to a task A task can have tickets linked to it, for example the incidents a fix is meant to solve. The task's card window lists them and lets you link or unlink tickets without leaving the board. Time logged on these tickets counts in the task's hours spent. ### 5.3.6.1 See the tickets of a task Open a task card. The **Tickets** section, under the checklist, lists each linked ticket with a ring showing its status, its number and title (a link to the ticket), its technician and the time logged on it. The ticket button in the window's button bar shows how many of the linked tickets are solved (here 1/2) and shows or hides the section. ![Tickets linked to a task — See the tickets of a task](https://docs.tic.gal/uploads/images/gallery/2026-09/Sp99jpebUIs7vmHH-embedded-image-bgs6osyc.png) ### 5.3.6.2 Link or unlink a ticket To link tickets, click **Link tickets** at the bottom of the section. It opens the same **Link tickets** window as the toolbar button (see [5.1.7.11 Link tickets to a project](https://docs.tic.gal/books/agile-project-management/page/51-the-board)), with the same search, **Select all shown** and **Clear**, but showing only this task's board tickets. To unlink one, click the broken-link icon at the end of its row: the ticket is removed from the task only and stays linked to the project, so its own card stays on the board. Both need the **Link tickets to a task** right; without it the section is read-only. ![Tickets linked to a task — Link or unlink a ticket](https://docs.tic.gal/uploads/images/gallery/2026-09/zsUDeL2WGFsoZzcl-embedded-image-kl58hzyu.png) ![Tickets linked to a task — Link or unlink a ticket](https://docs.tic.gal/uploads/images/gallery/2026-09/gXsca9YRzjB5XH4c-embedded-image-lgyvnwsa.png) ## 5.3.7 Deleted task cards When a task is deleted, its card remains on the board (grayed out) until it is purged. You can restore or purge deleted tasks. ### 5.3.7.1 Show deleted tasks By default, deleted task cards are hidden. Click the trash icon in the toolbar to show them. Deleted cards appear faded with a "Deleted" label. They are not counted in the column totals, and no filter or search matches them. A deleted card can only be restored or purged, not edited or moved. ![Deleted task cards — Show deleted tasks](https://docs.tic.gal/uploads/images/gallery/2026-09/uTd6aYD3cCyCJZkH-embedded-image-qmdh941o.png) ### 5.3.7.2 Restore a deleted task Open a deleted task card and click **Restore** in the action bar. The task is restored and becomes fully editable again. You must have the **Restore a card** right. ![Deleted task cards — Restore a deleted task](https://docs.tic.gal/uploads/images/gallery/2026-09/o4JsQwJtx6bESqIE-embedded-image-9dlzbb7y.png) ### 5.3.7.3 Permanently delete (purge) a task Open a deleted task card and click **Purge** in the action bar. The task is permanently deleted and cannot be restored. You must have the **Permanently delete a card** right. > **Note:** Restoring and purging require their own rights (**Restore a card** and **Permanently delete a card**). Without them, deleted cards cannot be acted on. > Generated for **Agile Project Management 2.2.0-beta.2** on GLPI 11.0 — 2026-09-27.