---
title: "Tasks: troubleshooting tasks"
description: "Task best practices and troubleshooting for some typical task issues. See right away why a task failed, and save named, filtered views of the failed task overview to share with colleagues, just like order list views."
url: https://help.qargo.com/us/articles/431269-tasks-troubleshooting-tasks
locale: us
updated: 2026-06-16
---

# Tasks: troubleshooting tasks

* * *

## Qargo tasks: creation best practices {#h_385530cf56}

-   Use standard task templates configured in Qargo
-   Keep naming, email bodies, and schedules consistent.
-   Confirm recipients and email content for Contact tasks

    -   When configuring tasks to email load sheets, make sure the **Addressed to** field is set to **Contract carrier** and the **Context role** field is set to **Driver**. This makes sure emails are sent to all drivers, including those linked to contract carriers.
-   Verify **From**, **Addressed to**, **Subject**, and **Body** before enabling a flow.
-   Choose the right execution mode per task type
-   Manual complete vs. Auto-complete vs. Auto-skip. Document the reason in the task description.
-   Keep context linked
-   Make sure tasks reference the correct order, load, shipment, contract carrier, or customer so downstream actions pick up the right data.
-   Schedule and dependencies
-   Order the task list logically and use conditions so only relevant tasks appear for departments, services, or scenarios.
-   Pre‐go‐live test
-   Do an end‐to‐end dry run in a sandbox tenant with realistic data and attachments.
-   Review task configurations regularly to make sure they align with operational needs, and test them with sample loads to confirm correct email delivery.

:::callout{tone="info"}
🧰 Qargo Onboarding Managers will assist with initial task workflow setups. For additional setup assistance, contact Qargo Support.
:::

* * *

## Qargo tasks: troubleshooting triage {#h_007722c949}

### Step 1: Identify the symptom {#h_3206be5f20}

-   Task is stuck (spinner) or never progresses
-   Document updated but contact email still shows old document
-   Skip vs. Reset confusion on task panes
-   Audit/history looks incomplete for shipments
-   Contact task didn't re-send after a change

### Step 2: Quick checks in Qargo {#h_6e1abed0dc}

-   Reload the page and reopen the task to confirm status
-   Check if the task needs a retry
-   Distinguish between document generation and sending via Contact task
-   Expand operations/shipment sections when reviewing history
-   Validate that task conditions didn't hide the task due to department/service filters

### Step 3: Fixes in Qargo {#h_fc16d0a471}

-   Stuck task

    -   Reset the task back to TODO and retrigger it. If queued work was lost, a retry usually resolves the issue.
-   Document regenerated but email unchanged

    -   Regenerating a load sheet or document does not re-send it. Re-run the related Contact task to email the latest version.
-   Skip vs. Reset

    -   Some default tasks (e.g., certain post‑invoice steps) cannot be skipped by design. Use Reset to return to TODO.
-   Audit trail seems incomplete

    -   Expand the shipment in the order's operations panel to reveal shipment documents and tasks in history.
-   Contact task visibility after earlier send

    -   Previously sent emails won't update automatically. Generate the new document and run the Contact task again.

* * *

## Failed task overview {#h_6250a9ee76}

:::callout{tone="info"}
🧰 _Super Admin_ access to create, edit, and share shared views. Regular users can still create personal views.
:::

## Terminology {#h_3ce82c7ecb}

| **Term** | **Definition** |
| --- | --- |
| _Task_ | A background action in Qargo such as a container booking, document generation, dispatch task, or rule. |
| _Failed task overview_ | The shared list of all failed tasks across the tenant. |
| _Error details dialog_ | The existing dialog showing the complete error information for a failed task. |
| _Saved view_ | A stored filter configuration plus column ordering and visibility on the failed task overview. |
| _Shared view_ | A saved view made available to other users; only Super Admins can create, edit, and share these. |
| _Personal view_ | A saved view available only to the user who created it. |

## Viewing errors {#h_24e2f7ab1e}

-   **Hover tooltip:** Hovering over the failed task icon in list and overview views shows the error message right away, without opening anything.

    ![](https://help.qargo.com/media/fb10ea0f2e2d-image.png)

-   **Detail pages:** The full error message is shown inline on the related **Order**, **Load**, and **Stop** detail pages, keeping the existing **Show more** option for the complete details.

    ![](https://help.qargo.com/media/3fd7bce8f1fb-image.png)

-   **Failed task overview:** A dedicated, filterable error column shows each failed task's error per row, without opening the **Error details** dialog.

    ![](https://help.qargo.com/media/8c8e16506f91-image.png)


The change applies to all task types and all task errors, not only container booking tasks.

## Filtering on errors {#h_b65bc007f2}

1.  **Navigate** to the failed task overview.
2.  **View** the error column showing the error message per row.
3.  **Filter** on the error column to narrow the list to the relevant failures.

    ![](https://help.qargo.com/media/953da9a159cd-image.png)


## Creating and sharing a view {#h_146d27d36f}

1.  **Navigate** to the failed task overview.
2.  **Apply** the required filters and column configuration.
3.  **Select** **\+ View** and **save** the result as a named view.
4.  **Share** the view via **Share with other users**, choosing **All users**, **Private**, or **Specific users**.

    ![](https://help.qargo.com/media/9e10188ed1a1-image.png)


:::callout{tone="info"}
🧰 _Super Admin_ access to create, edit, and share shared views. Regular users can still create personal views.
:::

### Troubleshooting {#h_774e99f37d}

| **Issue** | **Cause / resolution** |
| --- | --- |
| The error message is truncated on a detail page. | Use the **Show more** option to open the complete error details. |
| The error column is not visible in the overview. | Confirm column visibility settings; the error column can be shown alongside the other columns. |
| The **Share with other users** option is unavailable. | Only Super Admins can create, edit, and share shared views. Regular users can create personal views only. |
| A saved view does not keep its columns. | A saved view stores filters together with column ordering and visibility; re-save the view after adjusting columns. |

* * *

## Bulk retrigger, reset, and skip failed tasks {#h_d7b8a8306f}

### How to bulk manage failed tasks {#h_d6fa7e0eb5}

1.  **Navigate** to the **Failed tasks** page (accessible via **Configuration > Automation > Failed tasks**, or via the failed tasks notification indicator in the header).
2.  **Click** the quick action button in the top-right area of the **Failed tasks** table.
3.  **Select** one of the three bulk actions from the dropdown: **Retrigger tasks**, **Reset tasks**, or **Skip tasks**.
4.  **Check** the checkboxes next to each task to include. Tasks that are incompatible with the selected action are grayed out and cannot be selected.
5.  **Review** the footer, which shows the selected action name and enables the **Execute** button once at least one task is selected.
6.  **Click** **Execute** to apply the action to all selected tasks, or **Cancel** to return to the default view without applying changes.

### Troubleshooting {#h_af61daba65}

| **Symptom** | **Likely cause** | **Action** |
| --- | --- | --- |
| A task is grayed out and cannot be selected | The task is not eligible for the selected action type | Switch to a different action type, or manage the grayed-out task individually |
| **Execute** button is disabled | No tasks have been selected | Select at least one checkbox before clicking **Execute** |
| Tasks reappear as failed after retriggering | The underlying cause of the failure has not been resolved | Investigate and resolve the root cause before retriggering |
| A task is stuck in a loading state | The task is frozen mid-execution | Use **Reset tasks** to return it to its initial state |


## Related articles

- [Tasks - Contact tasks: Viewing and sending documents](https://help.qargo.com/us/articles/596071-tasks-contact-tasks-viewing-and-sending-documents.md)
- [Tasks: add workflow tasks](https://help.qargo.com/us/articles/133819-tasks-add-workflow-tasks.md)
- [Tasks: what, why, and how?](https://help.qargo.com/us/articles/246335-tasks-what-why-and-how.md)
- [Save views on the order list page](https://help.qargo.com/us/articles/142212-save-views-on-the-order-list-page.md)
- [Orders: orders list view functions](https://help.qargo.com/us/articles/133839-orders-orders-list-view-functions.md)
