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

# Study Blocks: Scheduling and Tracking Daily Sessions

> Study blocks are the core scheduling unit in Take Time. Each block ties a time slot to an activity, topic, and completion state on a specific date.

A study block is a time-boxed slot on a specific date that links a subject or activity to a start and end time. Blocks are the main unit of your daily schedule — you check them off as you complete them, and Take Time tracks your progress over time.

## What Is a Block?

Every block represents a single scheduled session. When you open your daily view, each block shows you exactly what to work on, when to start, and when to stop. Completing blocks is how Take Time measures your consistency and builds your stats.

A block carries the following fields:

| Field        | Type           | Description                          |
| ------------ | -------------- | ------------------------------------ |
| `id`         | string         | Unique identifier for the block      |
| `subject_id` | string         | The activity this block belongs to   |
| `date`       | string         | Session date in `YYYY-MM-DD` format  |
| `start`      | string         | Start time in `HH:MM` format         |
| `end`        | string         | End time in `HH:MM` format           |
| `topic`      | string \| null | Optional focus topic for the session |
| `done`       | boolean        | Whether you have completed the block |

Here is an example block as returned by the API:

```json theme={null}
{
  "id": "blk_abc123",
  "subject_id": "sub_xyz",
  "subject_name": "JavaScript",
  "date": "2026-06-11",
  "start": "09:00",
  "end": "10:00",
  "topic": "Ch. 3 — Arrays",
  "done": false
}
```

<Note>
  The `topic` field on a Study block corresponds to a syllabus item from that subject's profile. When you open the block, Take Time presents a picker pre-populated with the syllabus entries you have defined — so you always know exactly which part of your material to tackle.
</Note>

## Block Types

Every block inherits its type from the subject it belongs to. The type controls what appears inside the block when you open it during a session.

<CardGroup cols={3}>
  <Card title="Study" icon="book-open">
    Displays a **syllabus topic picker** so you can select the exact chapter or concept you are covering. Mark the topic done to record syllabus progress alongside the block itself.
  </Card>

  <Card title="Training" icon="dumbbell">
    Displays an **exercise checklist** pulled from the subject's exercise sheet. Check off each set or drill as you finish it.
  </Card>

  <Card title="Routine" icon="list-check">
    Displays a **micro-habit checklist** drawn from the subject's habit list. Tick each habit to log it as complete for the day.
  </Card>
</CardGroup>

## How Blocks Are Created

Take Time gives you two ways to add blocks to your schedule:

<Steps>
  <Step title="Manually add a block">
    Tap the **+** button on the schedule view for any day. Choose a subject, set the start and end time, and optionally select a topic. The block appears immediately on that day only.
  </Step>

  <Step title="Auto-generation from weekly slot profiles">
    When you define a weekly slot on an activity (for example, every Monday and Wednesday from 09:00 to 10:00), Take Time automatically generates a block for each matching day when you load that day's schedule. You set the slot once, and your calendar fills in automatically.
  </Step>
</Steps>

## Marking Blocks Done

Tap the completion toggle on any block to mark it done. Take Time immediately records the completion and updates:

* **Activity heatmap** — the cell for today gains intensity based on total completions
* **Streak counter** — your consecutive-days streak extends if this is your first completion today
* **Completion rate** — the ratio of completed blocks to total scheduled blocks recalculates in real time

You can unmark a block as done at any time. All stats update accordingly when you do.

## Deleting a Block

<Warning>
  Deleting a block removes only that specific day's occurrence. It does **not** modify the weekly slot profile that generated it. The next time Take Time auto-generates blocks for a future day, a new block will appear as normal. To stop a block from appearing on future days, edit or delete the slot profile on the activity itself.
</Warning>

To delete a block, swipe it in the schedule view and confirm the deletion. Manual blocks are removed permanently. Profile-generated blocks will be recreated on subsequent days unless you update the underlying slot.