Skip to main content
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:
FieldTypeDescription
idstringUnique identifier for the block
subject_idstringThe activity this block belongs to
datestringSession date in YYYY-MM-DD format
startstringStart time in HH:MM format
endstringEnd time in HH:MM format
topicstring | nullOptional focus topic for the session
donebooleanWhether you have completed the block
Here is an example block as returned by the API: 
{
  "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
}
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.

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

Study

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.

Training

Displays an exercise checklist pulled from the subject’s exercise sheet. Check off each set or drill as you finish it.

Routine

Displays a micro-habit checklist drawn from the subject’s habit list. Tick each habit to log it as complete for the day.

​
How Blocks Are Created

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

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

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.

​
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

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