# Benutzerdefinierte Felder

> Die zusätzlichen Registrierungsdaten der Mitglieder (Firma, Position, Stadt, Ticketart) - Typen, Pflichtfeld, wer sieht und wer bearbeitet, die Bitte um Vervollständigung beim Besuch und die Variable in Kampagnen.

**Benutzerdefinierte Felder** sind die Angaben, die die Community über Name, E-Mail und Telefon hinaus zu jedem Mitglied speichern möchte: Firma, Position, Stadt, Geburtsdatum, Ticketart. Das Team legt die Felder einmal an; die Werte erscheinen im Datensatz jedes Mitglieds, im Profil der Person selbst und in den E-Mail-Kampagnen.

## Wofür das gut ist

| Community | Felder |
|---|---|
| Verband | *Firma*, *Position*, *Mitgliedsnummer* |
| Event | *Ticketart* (Auswahl), *Stadt* |
| Schule | *Klasse*, *Einschreibedatum* |
| Coworking | *Etage*, *Hat einen Parkplatz* (Ja/Nein) |

## So funktioniert es

### Die Typen

| Typ | Wofür | Beispiel |
|---|---|---|
| **Text** | Beliebiger kurzer Text | Firma |
| **Zahl** | Eine Zahl | Mitgliedsnummer |
| **Datum** | Ein Datum | Geburtsdatum |
| **Auswahl** | Eine Option aus einer Liste (mindestens zwei) | Ticketart: VIP, Vor Ort, Online |
| **Ja/Nein** | Eine Ja-oder-Nein-Antwort | Hat einen Parkplatz |

Der Typ **ändert sich nicht mehr**, sobald ein Mitglied einen Wert hat: *„Der Typ ändert sich nicht mehr, sobald Werte ausgefüllt sind.“*

### Pflichtfeld

Ein **Pflichtfeld** muss von allen ausgefüllt werden. Wer den Wert nicht hat (altes, importiertes oder neues Mitglied), sieht beim **nächsten Besuch** der Community das Fenster **Registrierung vervollständigen** (*„{Name der Community} benötigt diese Angaben, damit Sie fortfahren können.“*) und kommt erst weiter, nachdem er sie ausgefüllt und auf **Speichern und fortfahren** geklickt hat. Wer möchte, kann sich **Abmelden**.

Der [Tabellenimport](/membros/importar-membros) hält nie eine Zeile wegen eines leeren Pflichtfelds auf; die Person ergänzt es beim ersten Besuch.

### Wer sieht und wer bearbeitet

| Wer | Sieht | Bearbeitet die Werte |
|---|:-:|:-:|
| Eigentümer, Administrator und Moderator | Von allen | Von allen |
| Finanzen | Von allen | Nur die eigenen |
| Das Mitglied selbst | Die eigenen | Die eigenen |
| Ein anderes Mitglied | — | — |

**Felder** anlegen, bearbeiten, sortieren und löschen dürfen Eigentümer und Administrator. Moderator und Finanzen sehen den Tab nur zum Nachschlagen: *„Sie sehen die Felder, aber nur Owner und Admin erstellen, bearbeiten oder löschen sie.“*

Die Felder erscheinen nicht im öffentlichen Profil: Ein anderes Mitglied sieht weder Firma noch Position von irgendjemandem.

> [!TIP]
> Die Ansicht selbst erinnert daran: *„Fragen Sie keine sensiblen Daten (Gesundheit, Religion, Ausweise) ohne Notwendigkeit ab.“*

### Wo die Werte erscheinen

- **Datensatz des Mitglieds** (Team): unter **Verwaltung › Mitglieder**, beim Bearbeiten der Person, der Abschnitt **Zusätzliche Angaben**, mit **Angaben speichern**. Bei Personen aus einem Import steht dort auch *„Herkunft: Tabellenimport am …“*.
- **Mein Konto** (das Mitglied selbst): die Karte **Zusätzliche Angaben**, *„Felder, die die Community bei der Registrierung abfragt.“*
- **E-Mail-Kampagnen:** Jedes Feld wird eine Variable (siehe unten).

### In Kampagnen

Jedes Feld wird zur Variable `{{campo_<schlüssel>}}`; der Schlüssel ist der Feldname ohne Akzente, kleingeschrieben und mit `_` statt Leerzeichen: Das Feld *Firma* wird zu `{{campo_firma}}`, *Ticketart vor Ort* zu `{{campo_ticketart_vor_ort}}`. `{{field_<schlüssel>}}` geht auch. Der Schlüssel entsteht mit dem Feld und ändert sich nicht, auch wenn der Name später geändert wird.

Im Editor zeigt **Variable einfügen** die Felder in der Gruppe **Community-Felder**, mit dem richtigen Namen. Der Wert erscheint für die empfangende Person formatiert: das Datum in ihrer Sprache, Ja/Nein übersetzt, die Auswahl als Option. Für Personen ohne Wert nutze den Ersatztext: `{{campo_firma|deine Firma}}`. Siehe [Variablen pro Empfänger](/notificacoes/campanhas-de-email#variablen-pro-empfanger).

### Ein Feld löschen

Das Feld verschwindet aus dem Tab, dem Datensatz, dem Profil und den Kampagnenvariablen. Bereits ausgefüllte Werte **bleiben gespeichert**. Eine Kampagne, die noch die Variable eines gelöschten Felds nutzt, wird beim Speichern oder Senden abgelehnt.

## Schritt für Schritt

*Rolle: Eigentümer oder Administrator.*

1. **Verwaltung › Mitglieder**, Tab **Benutzerdefinierte Felder**, Schaltfläche **Neues Feld**.
2. **Feldname** (z. B. *Firma*) und **Typ**. Bei einer **Auswahl** schreibe die **Optionen** (**Option hinzufügen** für eine weitere).
3. Hake **Pflichtfeld** an, wenn alle es ausfüllen müssen.
4. **Speichern**. Mit **Nach oben** und **Nach unten** änderst du die Reihenfolge, in der die Felder im Datensatz und im Profil erscheinen.

Um den Wert einer Person auszufüllen: **Verwaltung › Mitglieder**, die Person bearbeiten und **Zusätzliche Angaben** nutzen.

## Beispiele

**Ein Verband fragt nach der Firma.** Der Administrator legt *Firma* an (Text, Pflichtfeld). Beim nächsten Besuch sieht jedes Mitglied **Registrierung vervollständigen** und füllt sie aus. Die Kongress-Kampagne beginnt mit *„{{nome}}, hat {{campo_firma|deine Firma}} den Platz schon gesichert?“*.

**Ein Event importiert die Ticketart.** Beim [Import](/membros/importar-membros) geht die Spalte *Ticketart* an **+ Neues benutzerdefiniertes Feld**; Memberfy schlägt **Auswahl** vor, weil sich die Werte wiederholen. Danach sieht das Team im Datensatz jeder Person, ob sie VIP, Vor Ort oder Online ist.

## Häufige Fehler und Lösungen

| Meldung | Was zu tun ist |
|---|---|
| *Geben Sie dem Feld einen Namen.* | Fülle den **Feldnamen** aus |
| *Eine Auswahl braucht mindestens zwei Optionen.* | Füge eine weitere Option hinzu |
| *Füllen Sie {Feld} aus.* | Das Feld ist Pflicht und darf nicht leer bleiben |
| *Nur lesen: Owner, Admin und Moderator bearbeiten diese Werte.* | Finanzen sieht die Werte der anderen nur |
| Der Typ lässt sich nicht ändern | Es gibt schon ausgefüllte Werte; lege ein neues Feld an |

## Häufige Fragen

**Sieht ein Mitglied die Felder der anderen?**
Nein. Jedes Mitglied sieht nur die eigenen; das Team sieht die von allen.

**Kann ich die Zielgruppe einer Kampagne nach einem Feld filtern?**
Noch nicht. Nutze vorerst [Tags](/membros/tags) oder [Gruppen](/membros/grupos-e-organograma), um Personen zu trennen.

## Über den Assistenten

`list_member_fields`, `create_member_field`, `update_member_field`, `reorder_member_fields`, `delete_member_field` (mit Bestätigung) und `update_member_field_values`. Siehe [Werkzeuge · Mitglieder](/mcp/ferramentas-membros#benutzerdefinierte-felder).

## In der API

`GET` und `POST /api/member-fields`, `PATCH` und `DELETE /api/member-fields/{id}`, `PUT /api/member-fields/order` und `PUT /api/profiles/{profileId}/fields`. Die Werte kommen in `fields` von `GET /api/profiles/{id}`, nur für das Team und das Mitglied selbst. Siehe [Member Fields](/api/referencia/member-fields) in der API-Referenz.

## Verwandte Artikel

- [Mitglieder per Tabelle importieren](/membros/importar-membros)
- [Mitglieder verwalten](/membros/gerenciar-membros)
- [E-Mail-Kampagnen](/notificacoes/campanhas-de-email)