---
title: "Elementen, versies en @handles"
description: "Castleden, sets, props en stijlen zijn elementen met versies en referentiebeelden, in elke shot aan te roepen met hun @handle."
url: https://www.filmsquare.ai/docs/nl/concepts/elements/
lang: nl
section: concepts
updated: 2026-11-15
mcp: [get_script, view_media, upload_file, find_actions, run_action]
---

# Elementen, versies en @handles

Een element is iets dat in elke shot hetzelfde moet uitzien: een castlid, een set, een prop of een stijl. Elk
element heeft een `@handle`, referentiebeelden en versies. Teken er één keer een af en roep het daarna in elke shot
aan met zijn handle.

![Het scherm Elements met cast, sets en props als kaarten en een filter per soort](https://www.filmsquare.ai/docs/shots/en/elements-desktop.webp)

## Soorten elementen

| Soort | In de app | Departement |
| --- | --- | --- |
| Character | Cast member | [Casting](https://www.filmsquare.ai/docs/nl/departments/casting/), [Kostuum](https://www.filmsquare.ai/docs/nl/departments/wardrobe/) |
| Location | Set | [Sets](https://www.filmsquare.ai/docs/nl/departments/sets/) |
| Prop | Prop | [Props](https://www.filmsquare.ai/docs/nl/departments/props/) |
| Style | Style | Een look: camera, lens, licht, grade, filmmateriaal. Zie [Styles](https://www.filmsquare.ai/docs/nl/concepts/styles/) |

Een kostuum is geen element op zich: het is een [look](https://www.filmsquare.ai/docs/nl/departments/wardrobe/) op een castlid, per scène.

## @handles

Elk element heeft een handle, zoals `@anna` of `@backlot-street`. Typ `@` in een prompt, een shotbeschrijving of de
composer om een element erbij te halen. Filmsquare voegt dan de referentiebeelden van het element voor je toe aan de
take, gekozen voor de shotgrootte en camerahoek van de shot.

Op het scherm **Elements** kopieert **Copy @handle** hem. **Search elements or @handle** vindt een element.

## Waar elementen wonen

Een element hoort bij één productie, of bij de hele workspace ("Every production in this workspace"). Een element
voor de hele workspace kun je in elke productie gebruiken; een eigen element van een productie alleen daar. In een productie werk je eraan onder **Cast & sets → Cast**,
**Locations** en **Props**, en aan stijlen onder **Create → Mood**. Een productie heeft ook een eigen
**Elements**-pagina, met een knop op de **Home** van een nieuwe productie: die toont de elementen van die productie en de workspace-brede die ze
gebruikt (gemarkeerd met **Every production**), zoals de elementen die haar geïmporteerde takes noemen. Wat je daar
toevoegt blijft in die productie. Een wijziging aan een workspace-breed element geldt overal, en crew wijs je alleen toe
aan de eigen elementen van een productie.

## Een element maken

- **Uit een breakdown:** een scriptbreakdown haalt de cast, sets en props binnen die hij vindt.
- **Add elements:** sleep op de Elements-pagina foto's ergens neer (of kies er meerdere). Elke foto wordt een
  conceptkaart met een soort en een naam uit de bestandsnaam (`chr_ines_v3.png` is het castlid Ines). Controleer
  beide en voeg ze met **Add** in één keer toe. Elke foto wordt de eerste referentie van het element.
- **Describe one:** kies een **Kind** en een **Name** en schrijf een zin. Filmsquare rendert een referentieblad en
  gebruikt het eerste.
- **Save as element:** maak van een take die je bevalt een castlid, set of prop. De take wordt zijn eerste referentie.
- **Uit een tag:** **Create** naast een tag onder **Script → Tagging** maakt het castlid, de set of de prop die erin
  genoemd wordt.
- **New look:** maak onder **Create → Mood** een stijl uit beelden die je selecteert. Zie
  [Het canvas](https://www.filmsquare.ai/docs/nl/working-together/canvas/#looks).
- **New style:** schrijf onder **Create → Styles** een style guide en voeg referentiebeelden toe, of gebruik er een uit de bibliotheek. Zie
  [Styles](https://www.filmsquare.ai/docs/nl/concepts/styles/).

## Versies

Elke wijziging in hoe een element eruitziet is een nieuwe versie. Versies veranderen nooit meer na het maken, dus
shots die er een gebruikten blijven reproduceerbaar. De nieuwste versie is **Current**; shots gebruiken de huidige
versie, tenzij een shot op een oudere is vastgezet.

Op de pagina van het element kopieert **New version** de huidige versie, met elke referentie, als de volgende. Voeg
daarna referenties toe of wijzig ze.

![De pagina van een element met zijn versies, referentiebeelden en sheets](https://www.filmsquare.ai/docs/shots/en/element-detail-desktop.webp)

> [!NOTE]
> Zodra er een take is gemaakt met een versie, liggen de referenties van die versie vast. Wil je een referentie
> toevoegen, maak dan een nieuwe versie. De API antwoordt met `409 element_version_frozen` en de uitweg.

## Referenties en sheets

Een referentie is een beeld van het element met een rol: front, three-quarter, profile, back, full body,
turnaround, expression, detail, wide en nog een paar. **Add reference** uploadt er een. Het
kruisje naast een beeld van de huidige versie haalt het weg: Filmsquare maakt een nieuwe versie zonder dat beeld,
oudere versies houden het.

Een **sheet** is een schone weergave van het element, gerenderd om als referentie te gebruiken. Render er een vanaf
de pagina van het element; klopt hij, kies dan **Sign off as reference**: Filmsquare maakt een nieuwe versie met dat
beeld erbij.

## Versies en aftekenen

Een nieuwe versie (v2 en hoger) van een element is een wijziging van afgetekend werk. Het laat zijn departement
verlopen in elke aflevering die nog in bewerking is en het element gebruikt:

| Element | Departementen die verlopen |
| --- | --- |
| Castlid | Casting, Kostuum, Stemmen |
| Set | Sets |
| Prop | Props |

Een nieuw element (v1) doet dat niet: de breakdown die het binnenbracht was al afgetekend. Zie
[Aftekenen en groen licht](https://www.filmsquare.ai/docs/nl/concepts/sign-off-and-gates/#when-a-sign-off-goes-stale).

## Archiveren

**Archive…** haalt een element uit de lijsten. Shots en takes die het gebruikten houden hun geschiedenis. Er wordt
niets verwijderd.

## Met je eigen Claude

`get_script` geeft de handles terug die een productie al heeft, zodat een breakdown ze hergebruikt. `view_media`
laat Claude een referentiebeeld zien; `upload_file` voegt een beeld toe als productie-asset voor een referentie.
Versies, referenties en sheets gaan via `find_actions` en `run_action` (bijvoorbeeld `forkElementVersion`,
`generateForElement`, `acceptElementTake`). `removeElementReferences` haalt oude beelden van een element: een
nieuwe versie zonder die beelden wordt de huidige, eerdere versies houden ze. Zie [Wat Claude kan doen](https://www.filmsquare.ai/docs/nl/claude/tools/).
