> ## 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.

# Calendar view

> See your tracked time as a week grid in TimeTracker. Drag to create entries, move and resize them, and switch between your calendar and a teammate's.

The Calendar shows a week of tracked time as a grid. You can draw a new entry
with your mouse, drag one to a different slot, and stretch it to change its
length.

## What it is

A seven-day time grid, from midnight to midnight, in 30-minute slots. It opens
scrolled to 08:00 and draws a line across the current time.

Each entry appears as a block showing:

* the project name (or the description, if there is no project)
* the task name
* the person's avatar and name
* the duration
* a **Billable** or **Non** chip

Days off and public holidays are shaded in the background, so a Saturday looks
different from a Tuesday.

## When to use it

* You think in blocks of the day rather than rows of a list.
* You want to spot gaps and double-bookings at a glance.
* You are reconstructing a day from your meeting calendar.
* You are a manager checking how a teammate's week actually ran.

## Opening it

The Calendar is not in the sidebar. Open it from the command palette:

<Steps>
  <Step title="Press ⌘K">
    Or **Ctrl+K** on Windows and Linux.
  </Step>

  <Step title="Type “calendar”">
    It appears under **Go to**.
  </Step>

  <Step title="Press Enter">
    The Calendar opens on the current week.
  </Step>
</Steps>

<Note>
  The Calendar belongs to the **Calendar** app. That app is a **Pro** feature and
  needs the **Resource Planner** app switched on. If either is missing, the page is
  not available. See [Apps and modules](/concepts/apps-and-modules).
</Note>

## The controls

| Control          | What it does                                                          |
| ---------------- | --------------------------------------------------------------------- |
| **‹** and **›**  | Step back and forward one week.                                       |
| **Jump to date** | Pick any date to move to that week.                                   |
| **Today**        | Return to the current week. It only appears when you have moved away. |
| The week label   | Shows which week you are looking at.                                  |
| **Add entry**    | Opens the entry form on the first day shown.                          |
| The scope picker | Choose **My calendar**, **All teammates**, or one person.             |

## Create an entry by dragging

<Steps>
  <Step title="Find the day and time">
    Scroll to the right part of the day.
  </Step>

  <Step title="Drag across the slot you worked">
    Press and drag from the start time to the end time.
  </Step>

  <Step title="Fill in the form">
    It opens on the **Start & end** tab with those exact times already filled.
    Add the project, task and description.
  </Step>

  <Step title="Save">
    Click **Save entry**. The block appears on the grid.
  </Step>
</Steps>

## Move or resize an entry

* **Drag a block** to a different time or day. It saves as soon as you drop it,
  with the toast "Entry updated."
* **Drag the bottom edge** to make it longer or shorter.
* **Click a block** to open the full form.

If a move is refused – say the day is locked – the block springs back to where it
was and you get an explanation.

<Warning>
  An entry you cannot edit shows a small padlock and a grey block. Submitted,
  approved, locked and invoiced entries all look like this.
</Warning>

## Seeing other people

The scope picker in the header controls whose entries you see.

| Choice            | What you get                                                                                      |
| ----------------- | ------------------------------------------------------------------------------------------------- |
| **My calendar**   | Just your own entries.                                                                            |
| **All teammates** | Everyone your supervision scope reaches, on one grid, each block tagged with the person's avatar. |
| A named person    | That one person's week.                                                                           |

When you are looking at someone else you get a banner: "Viewing Sarah Lin's
calendar." If you cannot edit their time it says "(read-only)".

The picker only appears if you hold `time.viewOthers`.

<Tip>
  The Calendar is the place to add time **for** someone else. Select that person,
  then click **Add entry** or drag on the grid. You need `time.editOthers`.
</Tip>

## Example

Priya Raman is checking how Northwind's week went before approvals.

1. She opens the Calendar and picks **All teammates**.
2. She sees Sarah's Monday is solid on **Website Redesign**, but Wednesday has a
   three-hour gap.
3. She switches the picker to **Sarah Lin** and clicks the gap.
4. Sarah confirms she was on a Bluebird Coffee call. Priya drags out a one-hour
   block, attaches the project, and saves it on Sarah's behalf.

## Permissions

| You need          | To                                      |
| ----------------- | --------------------------------------- |
| `time.track`      | Create entries on your own calendar     |
| `time.edit`       | Move, resize and edit your own entries  |
| `time.viewOthers` | Use the scope picker at all             |
| `time.editOthers` | Create or change someone else's entries |

Capability is only half of it. **Supervision scope** decides which people you can
select. A manager with `time.viewOthers` still only sees their own people – see
[Supervision scope](/concepts/supervision-scope).

## What happens next

An entry created here is an ordinary time entry. It joins your timesheet for that
period, counts toward the project budget, and freezes the rate that applied on
its date.

## Common questions

<AccordionGroup>
  <Accordion title="Why can I not find the Calendar in the sidebar?">
    It is reached from the ⌘K palette. Search for "calendar".
  </Accordion>

  <Accordion title="Is this the same as the Google Calendar sync?">
    No. This grid shows tracked time. The Google Calendar sync mirrors planned
    blocks from the Resource Planner. See [Google Calendar](/integrations/google-calendar).
  </Accordion>

  <Accordion title="What are the shaded days?">
    Non-working days from your schedule, and public holidays. They come from the
    Work schedules app – see [Working hours and days off](/schedules/working-hours-and-days-off).
  </Accordion>

  <Accordion title="Can I see a month at a time?">
    The Calendar is a week grid. For longer ranges, use a report – see
    [Date ranges and periods](/reports/date-ranges-and-periods).
  </Accordion>

  <Accordion title="Why does dragging do nothing?">
    Either you do not hold the capability to create there, or you are on **All
    teammates**, which is read-only for creating. Pick a single person first.
  </Accordion>
</AccordionGroup>

## Troubleshooting

| Problem                        | Cause                                                                                       |
| ------------------------------ | ------------------------------------------------------------------------------------------- |
| The page is unavailable        | The Calendar app is off, the Resource Planner app is off, or your plan does not include it. |
| No scope picker                | You do not hold `time.viewOthers`.                                                          |
| A moved entry snaps back       | The write was refused – a locked period, a submitted period, or a policy. Read the toast.   |
| Blocks are grey with a padlock | Those entries are past draft and cannot be changed here.                                    |

## Related guides

<CardGroup cols={2}>
  <Card title="How to track time" icon="clock" href="/time-tracking/how-to-track-time">
    Every way to record an hour.
  </Card>

  <Card title="Track time for someone else" icon="users" href="/time-tracking/track-time-for-someone-else">
    Log and fix a teammate's hours.
  </Card>

  <Card title="Planner vs tracked time" icon="calendar" href="/planner/planner-vs-tracked-time">
    Planned blocks are not tracked hours.
  </Card>

  <Card title="Apps and modules" icon="toggle-on" href="/concepts/apps-and-modules">
    Why an app may be missing.
  </Card>
</CardGroup>