Skip to main content
For TV show productions, Kitsu provides hierarchical organization through Episodes and Sequences, allowing you to structure content by broadcast episodes and narrative sequences.

Understanding the Hierarchy

TV Show productions use a three-level structure:
Production
  └── Episode (e.g., "Episode 01")
       └── Sequence (e.g., "SEQ010", "SEQ020")
            └── Shots
Episodes and Sequences are only available when the production type is set to TV Show.

Episodes

Episodes represent broadcast episodes or major divisions of your production.

Episode Properties

Name
string
required
The episode identifier (e.g., “E01”, “Episode 01”, “101”).
Description
text
Synopsis or notes about the episode content.
Status
select
Current episode status:
  • Running: Actively in production (default)
  • Standby: On hold or pending
  • Complete: Finished and delivered
  • Canceled: Not moving forward
Metadata
custom
Custom fields defined in production settings (e.g., air date, duration, episode number).

Creating Episodes

1

Navigate to Episodes

Select your TV Show production and go to the Episodes page.
2

Click New Episode

Click the New Episode button (visible to Managers only).
3

Enter Episode Details

  • Name: Episode identifier
  • Description: Optional synopsis
Additional metadata fields will appear if configured in production settings.
4

Create Tasks

After creating the episode, you can:
  • Create episode-level tasks (e.g., “Episode Edit”, “Episode Color”)
  • Add sequences within the episode

Managing Episodes

Editing Episodes

  1. Click the Edit icon next to an episode in the list
  2. Modify the name, description, or metadata
  3. Click Confirm to save changes

Episode Tasks

Episodes can have their own tasks for episode-level work:
  • Episode Editing: Assembling the episode from sequences
  • Episode Color Grading: Overall color correction
  • Episode Sound Design: Audio mixing and mastering
  • Episode Delivery: Final export and delivery
Create episode tasks by:
  1. Clicking the task cell in the episode list
  2. Selecting the task type
  3. Assigning to team members

Deleting Episodes

Deleting an episode removes all sequences, shots, and tasks within it. This action cannot be undone.
To delete an episode:
  1. Click the Delete icon (trash can)
  2. Type the episode name to confirm
  3. Click Confirm

Sequences

Sequences organize shots within episodes, typically representing scenes or narrative beats.

Sequence Properties

Name
string
required
The sequence identifier (e.g., “SEQ010”, “S01”).
Episode
reference
Which episode this sequence belongs to (automatically set based on current episode).
Description
text
Scene description or notes.
Metadata
custom
Custom fields for tracking sequence-specific information.

Creating Sequences

1

Select an Episode

Choose the episode from the episode selector dropdown, or click into an episode.
2

Navigate to Sequences

Go to the Sequences page (automatically scoped to the current episode).
3

Click New Sequence

Click the New Sequence button.
4

Enter Sequence Details

  • Name: Sequence identifier
  • Description: Scene description
  • Episode is automatically set to the current episode
5

Add Shots

After creating the sequence, add shots to it from the Shots page.

Managing Sequences

Editing Sequences

  1. Click the Edit icon next to a sequence
  2. Update the name, description, or metadata
  3. Click Confirm

Sequence Tasks

Like episodes, sequences can have sequence-level tasks:
  • Sequence Layout: Rough blocking and timing
  • Sequence Animation: Character animation
  • Sequence Lighting: Lighting setup
  • Sequence Compositing: Final comp

Moving Sequences Between Episodes

To move a sequence to a different episode:
  1. Edit the sequence
  2. Change the Episode field
  3. Save the changes
Moving a sequence also moves all its shots to the new episode.

Filtering and Searching

Episode Filtering

On the Episodes page, you can:
  • Search by name: Type in the search field
  • Filter by status: status=running, status=complete
  • Filter by metadata: Use custom metadata fields in searches
  • Department filter: Show only tasks for specific departments
Example searches:
e01                    # Find episode 1
status=running         # Show only running episodes  
airdate>2024-01-01     # Episodes airing after a date (if metadata configured)

Sequence Filtering

On the Sequences page:
  • Auto-scoped to episode: Sequences are filtered by the current episode
  • Search by name: Find specific sequences
  • Filter by metadata: Use sequence metadata fields
  • Advanced filters: Build complex queries with the filter builder
Example searches:
seq01                  # Find sequence 01
sequence=wip          # Sequences with tasks in progress

Metadata for Episodes and Sequences

Add custom metadata fields to track additional information:

Common Episode Metadata

  • Episode Number: Broadcast episode number
  • Air Date: Scheduled broadcast date
  • Duration: Target runtime
  • Script Date: When the script was finalized
  • Storyboard Status: Storyboard approval status

Common Sequence Metadata

  • Location: Where the scene takes place
  • Time of Day: Day/night/interior/exterior
  • Page Count: Script page range
  • Complexity: Simple/Medium/Complex
Add metadata in Production SettingsParametersMetadata Descriptors.

Working with Episode Context

Episode Selector

When working in a TV Show production, you’ll see an episode selector that affects:
  • Which sequences are visible
  • Which shots are visible
  • Which assets are shown (if episode-specific)
Options in the selector:
  • Specific episodes: View one episode at a time
  • All: View content across all episodes
  • Main: View only main/shared content

Context-Aware Navigation

Kitsu remembers your episode context:
  • Switching between Shots, Sequences, and Assets maintains the current episode
  • Breadcrumbs show: Production > Episode > Page
  • Quick switching between episodes via the selector

Statistics and Tracking

Episode Statistics

View production progress per episode:
  1. Navigate to Episode Stats from the main menu
  2. See task completion by episode
  3. Compare progress across episodes
  4. Identify bottlenecks
Statistics show:
  • Task status distribution
  • Time spent per episode
  • Completion percentage
  • Retake counts

Sequence Statistics

Track sequence-level metrics:
  1. Go to Sequence Stats
  2. View completion by sequence
  3. See shot counts per sequence
  4. Monitor time estimates vs. actuals

Creating Tasks for Episodes and Sequences

Bulk Task Creation

Create tasks for multiple episodes or sequences at once:
1

Select Entities

Check the boxes next to episodes or sequences.
2

Open Task Creation Modal

Click the Create Tasks button that appears.
3

Choose Task Type

Select which task type to create.
4

Confirm

Tasks are created for all selected entities.

Episode Task Types

Common task types for episodes:
  • Episode Edit: Assembling shots into the episode
  • Episode Color: Color grading the full episode
  • Episode Sound: Audio mixing and sound design
  • Episode QC: Quality control review
  • Episode Delivery: Final delivery and export
Configure these in Production SettingsTask Types (set entity type to “Episode”).

Sequence Task Types

Common task types for sequences:
  • Sequence Layout: Camera and blocking
  • Sequence Previz: Preview visualization
  • Sequence Animation: Animation supervisor review
  • Sequence Lighting: Lighting setup
  • Sequence Comp: Compositing

Export and Reporting

Exporting Episodes

From the Episodes page:
  1. Click the Export button
  2. CSV file includes:
    • Episode names
    • Descriptions
    • All metadata fields
    • Task status for each task type
    • Time spent
    • Assignees

Exporting Sequences

From the Sequences page:
  1. Filter to the desired episode(s)
  2. Click Export
  3. CSV includes sequence data and task information

Best Practices

Consistent Naming

Use consistent patterns for episode and sequence names:
  • Episodes: “E01”, “E02” or “EP01”, “EP02”
  • Sequences: “SEQ010”, “SEQ020” or “S01”, “S02”

Plan Your Structure

Decide on episode/sequence breakdown before production starts. Changes later can be disruptive.

Use Metadata Wisely

Add metadata fields that provide real value for tracking and reporting, not just for the sake of data.

Track Episode Status

Keep episode status current to help coordinate team efforts and communicate progress.

Common Workflows

Starting a New Episode

1

Create the Episode

Add a new episode with name and description.
2

Break Down into Sequences

Create sequences based on the script breakdown.
3

Create Shots

Add shots to each sequence.
4

Generate Tasks

Bulk-create tasks for all shots in the episode.
5

Assign Team

Assign tasks to artists and begin production.

Episode Delivery

1

Complete All Shots

Ensure all shot tasks are marked as Done.
2

Episode-Level Tasks

Complete episode edit, color, and sound tasks.
3

QC Review

Run quality control checks.
4

Mark Episode Complete

Change episode status to “Complete”.
5

Export and Deliver

Generate final deliverables.

Troubleshooting

Check: Ensure you have an episode selected in the episode selector. Sequences are episode-scoped.
Solution: Edit the sequence and change the Episode field to move it.
Check: Verify that task types are configured for Episode or Sequence entity types in Production Settings → Task Types.
Permission check: Only Manager and Admin roles can create episodes and sequences.

Next Steps

Creating Shots

Learn how to create and manage shots within sequences

Task Management

Understand how to manage tasks across episodes and sequences

Build docs developers (and LLMs) love