Location Management

Register and manage locations to maintain consistent backgrounds and settings across all cuts. The @LocationID system lets you reference locations effortlessly in your prompts.

Overview

Cutflow's location system works on an @ID basis, just like characters. Once you register a location, you can reference it in scripts and prompts using @LocationID. The location's scene description and images are then automatically incorporated into AI generation.

This guide covers location creation, the @LocationID system, location image management, and how to use locations in the Editor.

Creating a Location

Basic Information

To create a location, provide the following information:

Field	Required	Description	Constraints
@ID	Yes	Unique identifier for prompts/scripts	Starts with `@`, alphanumeric and underscores, max 50 characters
Name	Yes	Display name of the location	Max 100 characters
Scene Description	Yes	Detailed description of the location's visual characteristics	Max 2,000 characters
Reference Image	No	A reference image of the desired location appearance	1 image file

Creation Steps

In the Studio, select Locations from the sidebar.
Click the [+ New Location] button in the card grid.
Enter the required information in the creation dialog.
Upload a reference image if you have one.
Click the [Register] button.

Location Limit per Project

You can register up to 10 locations per project.

Location registration is free (no credit cost).
If you try to register more than 10, a notification will appear.
Delete unused locations to make room for new ones.

Writing Good Scene Descriptions

The scene description is used for location image generation and as background context for subsequent keyframe generation. The more specific and visually detailed it is, the more consistent your results will be.

Good example:

Interior of a cozy, small cafe. Warm-toned lighting casts a soft glow.
Wooden tables and chairs create a vintage atmosphere.
Through the large glass windows, the street is visible with afternoon
sunlight streaming in. Small paintings hang on the walls, and a coffee
machine sits on the counter.

Example to avoid:

Cafe

Tip: Use AI Description Assist to automatically generate a detailed scene description from just a few keywords (1 credit).

@LocationID System

What is @LocationID?

@LocationID is a unique identifier used to reference a registered location in scripts and prompts. It shares the same namespace as character @IDs, and uses the format @Cafe, @School, etc.

Shared Namespace with Characters

Character @IDs and location @IDs share the same namespace. This means you cannot assign the same @ID to both a character and a location within a project.

Scenario	Allowed
Character `@Seohee` + Location `@Cafe`	Yes
Character `@Seohee` + Location `@Seohee`	No (duplicate)

@Mention Autocomplete

When you type @ in a prompt field or in a script's Action block, a unified autocomplete dropdown appears showing both characters and locations.

Characters are shown with a person icon.
Locations are shown with a pin icon.
The list filters as you continue typing a name or @ID.

In a script's Location block, only locations are autocompleted.

How @LocationID Works

When a prompt includes @LocationID, Cutflow does the following:

Location detection: The @LocationID tag is identified in the prompt.
Automatic image reference: The location's Primary image is automatically attached as a reference image.
Scene description inclusion: The location's scene description is automatically included in the AI prompt.
Background consistency: The AI generates images with a consistent background based on the location image and description.

Note: You can mention characters and locations together. For example: @Seohee is drinking coffee at @Cafe.

Location Images

What Are Location Images?

Location images serve as visual references for a location. Similar to a character's Character Sheet, they act as the reference point for maintaining background consistency during keyframe generation.

Generating Images

Select a location in the Studio.
Click the [Generate Image] button in the detail panel.
The AI generates a location image based on the scene description.

Cost: Location image generation costs 10 credits.

Uploading Images

You can also upload your own photos or custom-made images as location images.

Click the [Upload] button in the detail panel.
Select an image file.
The uploaded image is added to the location image gallery.

Primary Image

Among multiple images, the one set as Primary is automatically referenced whenever @LocationID is mentioned.

Click the [Set as Primary] button on the desired image in the gallery to change it.
Each variation can have its own Primary image.

AI Description Assist

Enter a few keywords and let the AI automatically write a detailed scene description.

How to Use

Click the [AI Description Assist] button in the location detail panel.
Enter keywords (e.g., "vintage cafe, warm lighting, wooden interior").
The AI generates a detailed scene description based on your keywords.
Click the [Apply] button to save it immediately.

Cost: AI Description Assist costs 1 credit.

Variations

You can create multiple versions (variations) of a single location. For example, manage "daytime" and "nighttime" versions of the same cafe separately.

A Base variation is automatically created when you register a location.
Add more variations to manage different times of day, weather conditions, seasons, and more.
Each variation has its own image gallery and Primary image.
When generating keyframes in the Editor, you can select which variation to use from the Reference Images panel.

For more details on variations, see the Variation System guide.

Tips & Best Practices

Focus on visual elements in your scene descriptions: Including details like atmosphere, lighting, interior design, and color palette helps the AI generate consistent backgrounds.
Always generate a location image: While the AI can produce backgrounds from descriptions alone, having an image significantly improves consistency.
Keep @IDs short and intuitive: Use names like @Cafe, @School, @Park that immediately convey the location.
Make use of variations: Managing day/night, sunny/rainy, and seasonal versions as variations lets you efficiently produce a variety of scenes.
Take advantage of AI Description Assist: Get professional-quality scene descriptions for just 1 credit.

FAQ

Q. Can I create backgrounds without registering a location?

Yes. You can describe the background directly in your prompt. However, if the same location appears in multiple cuts, registering it makes it much easier to maintain consistency.

Q. Can I change a @LocationID?

Currently, @IDs are set at creation time and cannot be changed afterward. If you need a different @ID, delete the location and create a new one.

Q. What happens when I mention both a character and a location?

Both the character's Character Sheet and the location's Primary image are attached as reference images. The AI generates an image reflecting both the character's appearance and the background.

Q. Can I create multiple images for a location?

Yes. You can generate or upload multiple images per variation, and the one set as Primary is used as the default reference.

Related Docs

Character & Location Studio -- Full Studio page guide
Character Management -- @ID system, Character Sheet detailed guide
Variation System -- Location variation detailed guide
Cut Editor -- Using @LocationID in prompts