> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timetracker.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboards

> The TimeTracker dashboard shows your hours today and this week, your billable ratio, what needs attention, your queue and your pending approvals.

The dashboard is your personal starting page. It answers "what should I be doing right now?" in one screen, without you configuring anything.

## Dashboard versus report

|               | Dashboard                                   | Report                                     |
| ------------- | ------------------------------------------- | ------------------------------------------ |
| What it is    | A fixed set of widgets                      | A question you build                       |
| Configured by | Nobody – it is the same for everyone        | You                                        |
| Scope         | Your own work and your own responsibilities | Whatever you point it at                   |
| Output        | An on-screen summary                        | A table you can group, export and schedule |

Use the dashboard to start your day. Use a report to answer a specific question. See [/reports/overview](/reports/overview).

## Getting there

The dashboard lives at your workspace's **Dashboard** page. Open the command palette and search for "Dashboard" to jump to it.

<Note>
  The dashboard belongs to the **Reports** app. If Reports is switched off for the workspace, the dashboard is switched off with it. See [/concepts/apps-and-modules](/concepts/apps-and-modules).
</Note>

## The widgets

### Your Progress

The headline card, with three figures:

| Figure             | What it shows                                                              |
| ------------------ | -------------------------------------------------------------------------- |
| **Today**          | Hours you have tracked today                                               |
| **This Week**      | Hours you have tracked over the past week                                  |
| **Billable Ratio** | The share of that week's hours marked billable, as a percentage with a bar |

Deleted entries drop out of these totals immediately, not at the point they are permanently removed.

### Active Timer

A small card showing whether you have a timer running.

| State              | Shows                                     |
| ------------------ | ----------------------------------------- |
| A timer is running | **Running…** with a **Stop Timer** button |
| No timer           | **Stopped** with a **Start Timer** button |

See [/time-tracking/using-the-timer](/time-tracking/using-the-timer).

### Needs Attention

Appears only when something is waiting on you. Each item is a card with a title and a short line of context, plus a chevron to go and deal with it.

Items cover things you own and have not finished, such as a timesheet you have not submitted, an expense still in draft, or a task that needs you.

<Note>
  No cards here means nothing is outstanding. The section hides itself rather than showing an empty box.
</Note>

### Recent Activity

The tasks you have most recently tracked time against, each with its current status. Hover a row and a play control appears so you can pick the work back up.

Empty state: **"No recent task activity."**

### Pending Approvals

Appears only if things are waiting on **your** decision – timesheets and leave requests you are the reviewer for. Each row is one item, and clicking it takes you to the approval.

This section is about your responsibilities to other people, where **Needs Attention** is about your own work.

See [/approvals/overview](/approvals/overview).

### Up Next

Your task queue. Each card shows:

| Element  | What it shows                                 |
| -------- | --------------------------------------------- |
| Title    | The task name                                 |
| Status   | Its current status chip                       |
| Priority | Shown when it is anything other than none     |
| **Due**  | The due date. An overdue date is highlighted. |

Empty state: **"Your queue is clear!"**

## Empty and loading states

While the dashboard loads you see shimmer placeholders.

If you have no queue, no recent tasks, nothing needing attention, no approvals, no running timer and no hours this week, the whole page collapses to:

> **Nothing to report yet**
> Once your group tracks time and runs projects, your numbers show up here.

That is the normal state on your first day.

## What the dashboard does not show

The dashboard is scoped to you. It carries no workspace revenue, no project cost and no margin – those are report questions, and they live behind the cost and rate permissions.

| Want                              | Go to                                                                                     |
| --------------------------------- | ----------------------------------------------------------------------------------------- |
| Workspace revenue and margin      | A report on the **Projects** source – [/reports/report-sources](/reports/report-sources)  |
| Project health and budget burn    | The project overview – [/projects/project-overview-page](/projects/project-overview-page) |
| Who has not submitted a timesheet | A report on the **Timesheets** source                                                     |
| Receivables and aging             | The **Unpaid invoices** report – [/reports/report-templates](/reports/report-templates)   |

## Example

Sarah Lin opens Northwind Studio on Tuesday morning.

| Widget          | What she sees                                                 |
| --------------- | ------------------------------------------------------------- |
| Your Progress   | Today `0.00` hrs, This Week `14.50` hrs, Billable Ratio 86%   |
| Active Timer    | **Stopped**, with a **Start Timer** button                    |
| Needs Attention | One card – last week's timesheet is still a draft             |
| Recent Activity | "Homepage wireframes" and "Brand moodboard", both in progress |
| Up Next         | Three tasks, one due today                                    |

She submits the timesheet, starts a timer on "Homepage wireframes", and the Active Timer card flips to **Running…**.

Priya Raman opens the same page and also sees **Pending Approvals**, because Sarah's timesheet is now waiting on her.

## Permissions

The dashboard needs no capability of its own. It shows your own work, so there is nothing to gate.

Two things still shape it:

* **The Reports app must be on.** The dashboard sits inside the Reports app, so switching Reports off hides it.
* **Pending Approvals only appears if you are an approver.** A member with no approval rights never sees that section.

Everything on the dashboard is your own data, so supervision scope does not narrow it. See [/concepts/supervision-scope](/concepts/supervision-scope).

## What happens next

The dashboard updates live. Start a timer and the card changes. Submit a timesheet and the attention card clears. Nothing needs refreshing.

When you want a question the dashboard cannot answer, build a report – see [/reports/build-a-report](/reports/build-a-report).

## Common questions

<AccordionGroup>
  <Accordion title="Can I customise the dashboard?">
    No. It is a fixed set of widgets. Build a saved report for anything else you need on a regular basis.
  </Accordion>

  <Accordion title="Does everyone see the same dashboard?">
    The same widgets, different content. Every figure is your own work, and Pending Approvals only appears for approvers.
  </Accordion>

  <Accordion title="Why is there no revenue on my dashboard?">
    The dashboard is a personal work view, not a financial one. Money questions belong in reports, where the cost and rate permissions apply.
  </Accordion>

  <Accordion title="Why is the dashboard empty?">
    Nothing is outstanding and you have tracked no time this week. It fills in as soon as you start working.
  </Accordion>

  <Accordion title="Why can I not open the dashboard at all?">
    The Reports app is switched off for the workspace. An admin can turn it back on in Settings → Apps.
  </Accordion>

  <Accordion title="Does the billable ratio include deleted entries?">
    No. A deleted entry drops out of the today and week totals straight away.
  </Accordion>
</AccordionGroup>

## Troubleshooting

| Problem                                 | Why                                              | Fix                                                                                           |
| --------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------- |
| **Nothing to report yet**               | No hours, no tasks, nothing outstanding          | Track an hour or pick up a task                                                               |
| Today shows 0 but you tracked time      | The entry may sit on another day, or was deleted | Check the entry's date – [/time-tracking/edit-a-time-entry](/time-tracking/edit-a-time-entry) |
| **Pending Approvals** never appears     | You are not an approver for anyone               | Expected. See [/approvals/overview](/approvals/overview).                                     |
| The dashboard page is unreachable       | The Reports app is off                           | Settings → Apps – [/settings/apps](/settings/apps)                                            |
| **Up Next** is empty but you have tasks | Nothing is assigned to you                       | Check assignees – [/tasks/assignees](/tasks/assignees)                                        |

## Related guides

<CardGroup cols={2}>
  <Card title="Reports overview" icon="chart-bar" href="/reports/overview">
    Build the questions the dashboard cannot answer.
  </Card>

  <Card title="My tasks" icon="list-check" href="/tasks/my-tasks">
    The full view of your queue.
  </Card>

  <Card title="Using the timer" icon="play" href="/time-tracking/using-the-timer">
    Start and stop tracked time.
  </Card>

  <Card title="Approvals overview" icon="circle-check" href="/approvals/overview">
    Everything waiting on your decision.
  </Card>

  <Card title="Apps and modules" icon="toggle-on" href="/concepts/apps-and-modules">
    Why the dashboard follows the Reports app.
  </Card>
</CardGroup>
