---
title: "Import from Higgsfield"
description: "Bring your Higgsfield projects into Filmsquare by connecting Higgsfield or with your own Claude - folders, takes with their prompt and model, and your elements - and make shots from a folder."
url: https://www.filmsquare.ai/docs/claude/import-from-higgsfield/
lang: en
section: claude
updated: 2026-11-16
mcp: [find_actions, run_action]
---

# Import from Higgsfield

If your work already lives in Higgsfield, you do not start over. There are two ways in: connect Higgsfield and Filmsquare reads your projects itself, or
ask your own Claude to read them and hand them over. Either way Filmsquare copies the files into your production. The crew can then review, sign off, make
shots and keep generating from there.

Nothing changes in Higgsfield and the import uses no Higgsfield credits and no Filmsquare credits. Imported takes show "made in Higgsfield · no credits used"
instead of a price.

## Connect Higgsfield

No Claude needed. Filmsquare signs in to your Higgsfield account with your permission, read-only, and reads the projects you pick.

1. Open **Settings → Import** (or **Import from Higgsfield** in **New production**) and choose **Connect Higgsfield**.
2. Sign in to Higgsfield and allow Filmsquare. You come back to the screen you were on; on **Settings → Import** your projects open right away.
3. Choose **Choose projects**, tick the projects you want and choose **Arrange N projects**. One import takes projects from one Higgsfield workspace;
   clear the ticks to pick from another.
4. Arrange them in the import window (below) and choose **Import**. Filmsquare then reads the projects itself, and the progress shows live.

### What Filmsquare can and cannot do with the connection

- It can list your Higgsfield workspaces and projects, and read the folders, stills, takes, prompts and elements of the projects you import.
- It cannot generate, change, delete or publish anything in Higgsfield, and it never uses your Higgsfield credits.
- The connection is yours alone, in this workspace. Nobody else in the workspace can use it, and the sign-in is stored encrypted and never shown.

### Disconnect or reconnect

Open **Settings → Import**, open the menu next to Higgsfield and choose **Disconnect**. Filmsquare stops reading Higgsfield right away and forgets the
sign-in. **Switch account** in the same menu disconnects and shows how to sign in with another Higgsfield account. If Higgsfield no longer accepts the
sign-in, the import card, the progress and **Settings → Import** say so and offer **Reconnect Higgsfield**. If connecting Higgsfield is not set up on your
server, **Settings → Import** says so; the Claude route below still works.

## Ask your Claude

> [!NOTE]
> You need your Claude connected to Filmsquare, and the Higgsfield connector in the same Claude. See [Connect Claude](https://www.filmsquare.ai/docs/claude/connect/). The reading is done by
> your own Claude, on your own subscription, so Filmsquare pays no AI tokens.

Say which projects you want. For example:

- "Import my Higgsfield project Sherlock - EPS 8 into Filmsquare."
- "Bring all my Sherlock episodes from Higgsfield into Filmsquare."

Claude lists your projects and counts what is in them. For a big project (more than 200 takes and stills) it tells you the number first and asks whether to go on.
Then it stages the import and gives you a link.

## Arrange them in the import window

Claude's link, **Arrange N projects**, or an import listed under **Imports** in **Settings → Import** opens the import window in the studio. Nothing
comes in until you click **Import**. Closing the window takes you back to where you opened it.

1. Choose how projects are added by default: **Episodes of a series** or **Standalone productions**, and the format (series episode, short film, feature or trailer). The format sets the
   type of production and the aspect ratio.
2. Check the list. Filmsquare suggests a series and an episode number from the project names: "Sherlock - EPS 6", "Sherlock - EPS 8" and "Sherlock EPS 9" become one production
   *Sherlock* with episodes 6, 8 and 9. Lines Filmsquare arranged itself are marked *suggested*. Names that do not follow a pattern stay standalone.
3. Correct what is wrong: drag a line to another group, use **Move to…** on a line, select several lines and move them together, or make a **New series**. Every change is saved at once.
4. Read the checks next to the lines: two episodes with the same number, an episode that already exists (the import is added to it, nothing is replaced), a project you imported before
   (only the new takes come in), and whether the productions and the storage fit your plan.
5. Choose **Import**.

If you would rather stay in the chat, Claude can show you the suggestion, take your changes and confirm the plan for you.

## What comes in

- **Folders**, as nested in Higgsfield. A folder stays a folder: it does not turn into a scene by itself. When a project becomes an episode, its folders go under one folder named after the episode.
- **Takes and stills** (images and videos, and audio and files that sit in the project), each with the **prompt** and the **model** it was made with. Prompts keep
  their elements: a mention of an element in the prompt reads as its @handle.
- **Elements**: the characters, locations and props your takes use, once, as elements of your workspace with their reference images. Every production can use them.
  When Filmsquare reads Higgsfield itself, it brings in only the elements the project's prompts name, after the takes; your own Claude brings in every element of your Higgsfield workspace.
  If another Higgsfield workspace is selected, elements are skipped with a quiet warning and their prompt mentions stay as `@hf-…` placeholders.
- **Liked and favourite** marks. They are only a filter ("liked in Higgsfield"), never a pick. You choose the picks.

The same file in two folders is stored once. Importing again later adds only what is new: what is already in is recognised and skipped, and nothing is ever overwritten or deleted.

You see the progress live: folders, takes and elements, and any line that failed with the reason. Takes come in first; a take whose prompt names an element waits for that element. **Retry** runs the failed lines again, for example after an expired link.

## Make shots from a folder

An imported folder is a heap of material until someone decides what it is. On a folder, choose **Make shots from this folder** and pick an episode: every image or video becomes a shot in the
episode's first scene, with the file as an imported take. You can limit it to the ones you liked in Higgsfield. Doing it twice does not make double shots.

Where a prompt was imported, open the take and use **Use as starting prompt** to carry it into the composer of a shot.

## Storage and plan limits

Everything is copied into Filmsquare, so the files count toward your plan's storage. As a guide: a still is 1.6-2.8 MB, a video is about 1.5 MB per second (a 15-second 720p take is about 23 MB),
and Filmsquare adds about 25% for thumbnails and proxies. An episode of around 150 takes and 200 stills is roughly 3-4 GB.

> [!COST]
> Free includes 5 GB, about one such episode. Team includes 50 GB per seat, about 12-15 episodes. Beyond that, storage is 2 credits · €0.10 per GB per month. Importing itself costs no credits.

The Free plan also fits one production. The import window then says so, and suggests putting the projects in one series as episodes. If a plan limit stops an import, what is already in stays,
and **Retry** continues after you upgrade.

## How it works

With **Connect Higgsfield**, the Filmsquare server reads Higgsfield with your connection, one page at a time and with read tools only, and skips what is
already in. If reading stops, the progress shows the reason and offers **Read again**; when the connection expired, it also offers **Reconnect Higgsfield**.
Stopped projects stay marked **Stopped**, not complete. **Open productions** appears only after something came in.

With your Claude: your Claude reads Higgsfield with its own connector and delivers each project to Filmsquare in batches, using the tools in [What Claude can do](https://www.filmsquare.ai/docs/claude/tools/): it finds the import routes with `find_actions`
and runs them with `run_action`. Filmsquare then fetches the files itself. If the chat is interrupted, ask Claude to continue: it asks Filmsquare what is already in and delivers only the rest.
