NueForm

Auswahl-Fragetypen

Dokumentation für die Fragetypen Multiple Choice, Dropdown, Ja/Nein, Ranking, Matrix und Liste.

Multiple Choice

Präsentiere eine Liste von Optionen, aus denen der Teilnehmer wählen kann. Unterstützt Einzelauswahl, Mehrfachauswahl, freien „Sonstiges"-Text, Zufallsreihenfolge und alphabetische Sortierung. Jede Auswahl kann ein eigenes Bild, Video oder Icon tragen, und die Eigenschaft layout wechselt zwischen einer vertikalen Liste und einem Raster aus Bildkarten — dieser eine Typ deckt also sowohl reine Textoptionen als auch bildbasierte ab.

Multiple-Choice-Frage
Eine Multiple-Choice-Frage mit mehreren Optionen.

Typ-Bezeichner: multiple_choice

Eigenschaften

EigenschaftTypBeschreibungStandard
choicesChoice[]Array der Auswahloptionen. Jede Auswahl hat eine id, ein label und ein optionales media.[]
layoutstringWie die Optionen dargestellt werden: stacked (vertikale Liste, optional mit Vorschaubildern), blocks (Raster aus Bildkarten), staggered (inhaltsbreite Chips mit Umbruch) oder grid (Raster mit fester Spaltenzahl).stacked
allowMultiplebooleanErlaubt dem Teilnehmer, mehr als eine Option auszuwählen.false
allowOtherbooleanZeigt eine „Sonstiges"-Option mit Freitext-Eingabe, in die der Teilnehmer eine eigene Antwort tippen kann.false
randomizebooleanMischt die Reihenfolge der Optionen bei jeder Anzeige der Frage neu.false
alphabeticalOrderbooleanSortiert Optionen alphabetisch. Wird ignoriert, wenn randomize aktiviert ist (Zufallsreihenfolge hat Vorrang).false

Choice-Objekt

Jede Auswahl im choices-Array hat:

FeldTypBeschreibung
idstringEindeutiger Bezeichner dieser Auswahl. Wird in Logiksprüngen und der Bewertung verwendet.
labelstringDer Anzeigetext der Auswahl.
mediaQuestionMediaOptionales Bild, Video oder Icon für diese Auswahl. Setze media.display, um die Darstellung zu steuern — siehe unten.

Auswahl-Medien

Jede Auswahl kann eigene Medien tragen. media.display bestimmt, wie sie auf der Auswahl sitzen:

DarstellungBeschreibung
thumbnailEin kleines Bild neben der Auswahlbeschriftung.
backgroundDas Bild füllt die Auswahlfläche und wird dafür beschnitten.
background-fitDas Bild füllt die Auswahlfläche, bleibt aber vollständig sichtbar und wird gegen die Hintergrundfarbe der Auswahl mit Rändern dargestellt.

Auswahl-Medien unterstützen dieselben Bearbeitungen wie Fragen-Medien — Filter, Farbton, Rahmen, Fokuspunkt und Zoom. Siehe Darstellung von Auswahl-Medien dazu, wie sich Füllen und Einpassen unterscheiden und wann du welches wählst.

Auswahl-Medien sind das, was aus dem früheren Fragetyp Bildauswahl geworden ist. Für ein Raster aus Bildkarten nutzt du Multiple Choice mit layout: "blocks" und gibst jeder Auswahl ein media-Objekt. Aus Typeform importierte Formulare wandeln picture_choice-Fragen automatisch in diese Form um.

Validierung

Ist required auf true gesetzt, muss der Teilnehmer mindestens eine Option auswählen, bevor er fortfahren kann.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Bei equals oder not_equals ist der Vergleichswert die Auswahl-ID. Bei Mehrfachauswahl-Fragen prüft equals, ob der Wert unter den ausgewählten Elementen ist.

Antwortformat

  • Einzelauswahl (allowMultiple: false): Ein string (die ausgewählte Auswahl-ID).
  • Mehrfachauswahl (allowMultiple: true): Ein Array von Strings (die ausgewählten Auswahl-IDs).

Bewertung im Quiz-Modus

Multiple Choice ist in allen Quiz-Modi ein bewertbarer Fragetyp:

  • Wissensquiz: Setze correctAnswers (Array der richtigen Auswahl-IDs) und correctAnswerScore (Punkte pro richtiger Antwort).
  • Lead-Qualifizierung: Setze choiceScores (Zuordnung von Auswahl-ID zu Punktwert).
  • Match-Quiz: Setze choiceOutcomes (Zuordnung von Auswahl-ID zu Endbildschirm-Fragen-IDs).

Für die Auswahl stehen Tastenkürzel zur Verfügung. Teilnehmer können Buchstabentasten (A, B, C usw.) drücken, um Optionen auszuwählen — die Kürzel erscheinen als Indikatoren neben jeder Option.


Ein Dropdown-Menü zur Auswahl aus einer Optionsliste. Unterstützt dieselbe Konfiguration wie Multiple Choice, zeigt die Optionen aber in einem kompakten Dropdown-Format. media pro Auswahl und layout gelten hier nicht — ein Dropdown stellt seine Optionen immer als reinen Text dar.

Dropdown-Frage
Eine Dropdown-Auswahlfrage.

Typ-Bezeichner: dropdown

Eigenschaften

EigenschaftTypBeschreibungStandard
choicesChoice[]Array der Auswahloptionen.[]
allowMultiplebooleanErlaubt die Auswahl mehrerer Optionen aus dem Dropdown.false
allowOtherbooleanZeigt eine „Sonstiges"-Option mit Freitext-Eingabe.false
placeholderstringPlatzhaltertext, der vor einer Auswahl angezeigt wird.Keiner
randomizebooleanMischt die Reihenfolge der Optionen.false
alphabeticalOrderbooleanSortiert Optionen alphabetisch.false

Validierung

Ist required auf true gesetzt, muss der Teilnehmer mindestens eine Option auswählen.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

  • Einzelauswahl: Ein string (die ausgewählte Auswahl-ID).
  • Mehrfachauswahl: Ein Array von Strings (die ausgewählten Auswahl-IDs).

Bewertung im Quiz-Modus

Dropdown ist ein bewertbarer Fragetyp. Die Bewertungskonfiguration ist identisch mit Multiple Choice.


Bildauswahl

Bildauswahl ist kein eigener Fragetyp mehr. Sie wurde in Multiple Choice überführt — es gibt keinen picture_choice-Bezeichner mehr, den du auswählen könntest.

Um dasselbe zu bauen, nutzt du eine Multiple-Choice-Frage mit layout auf blocks und einem media-Objekt an jeder Auswahl. Alles, was die Bildauswahl konnte, steht weiterhin zur Verfügung — dazu die Bearbeitungen, die sie nie hatte: Video- und Icon-Auswahlen, Filter, Farbton, Fokuspunkt, Zoom und ein Einpassen-Modus, der breite Bilder vollständig zeigt, statt sie zu beschneiden.

Auswahlen als Bildkarten
Multiple Choice mit layout: blocks — das Raster aus Bildkarten, das die Bildauswahl ersetzt hat.
json
{
  "type": "multiple_choice",
  "properties": {
    "layout": "blocks",
    "choices": [
      { "id": "c1", "label": "Mountains", "media": { "type": "image", "url": "https://…", "display": "background" } },
      { "id": "c2", "label": "Coast", "media": { "type": "image", "url": "https://…", "display": "background" } }
    ]
  }
}

Bestehende Formulare und Typeform-Importe werden für dich übernommen — eine picture_choice-Frage wird automatisch in Multiple Choice mit layout: "blocks" umgewandelt, du musst also nichts neu anlegen.


Ja / Nein

Eine einfache binäre Frage mit „Ja"- und „Nein"-Schaltflächen.

Ja/Nein-Frage
Eine binäre Ja/Nein-Auswahlfrage.

Typ-Bezeichner: yes_no

Eigenschaften

Der Ja/Nein-Fragetyp hat über die gemeinsamen Frageeigenschaften hinaus keine zusätzlichen Eigenschaften.

Validierung

Ist required auf true gesetzt, muss der Teilnehmer entweder „Ja" oder „Nein" anklicken.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Vergleiche bei equals gegen true (Ja) oder false (Nein). Die String-Werte "true" und "false" werden ebenfalls akzeptiert.

Antwortformat

Die Antwort wird als boolean gespeichert (true für Ja, false für Nein, oder null, wenn unbeantwortet).

Bewertung im Quiz-Modus

Ja/Nein ist ein bewertbarer Fragetyp:

  • Wissensquiz: Setze correctAnswers mit einem einzelnen Wert "true" oder "false".
  • Lead-Qualifizierung: Setze choiceScores mit den Schlüsseln "true" und "false".
  • Match-Quiz: Setze choiceOutcomes mit den Schlüsseln "true" und "false".

Die Ja/Nein-Frage springt sofort nach der Auswahl automatisch zur nächsten Frage weiter. Es gibt keine separate „OK"-Schaltfläche.


Ranking

Präsentiere eine Liste von Elementen, die der Teilnehmer per Drag-and-drop in seine bevorzugte Reihenfolge bringt.

Ranking-Frage
Eine Frage zum Ziehen und Sortieren, bei der Teilnehmer Elemente umordnen.

Typ-Bezeichner: ranking

Eigenschaften

EigenschaftTypBeschreibungStandard
choicesChoice[]Array der zu sortierenden Elemente. Jedes hat eine id und ein label.[]

Validierung

Ist required auf true gesetzt, muss der Teilnehmer ein Ranking übermitteln (alle Elemente müssen in einer definierten Reihenfolge sein).

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als Array von Strings gespeichert (Auswahl-IDs in der vom Teilnehmer gewählten Reihenfolge, von zuerst bis zuletzt).

json
["choice_3", "choice_1", "choice_2"]

Das Ranking-Feld nutzt Drag-and-drop-Interaktion. Auf Mobilgeräten können Teilnehmer Elemente per Touch-Gesten umsortieren.


Matrix

Ein rasterbasierter Fragetyp, bei dem Teilnehmer mehrere Elemente (Zeilen) über mehrere Kategorien (Spalten) bewerten. Jeder Schnittpunkt aus Zeile und Spalte ist eine auswählbare Option.

Matrix-Frage
Eine Matrix-Rasterfrage mit Zeilen und Spalten.

Typ-Bezeichner: matrix

Eigenschaften

EigenschaftTypBeschreibungStandard
rowsstring[]Array der Zeilenbeschriftungen (die zu bewertenden Elemente).[]
columnsstring[]Array der Spaltenbeschriftungen (die Bewertungskategorien).[]
randomizeRowsbooleanMischt die Reihenfolge der Zeilen.false
randomizeColumnsbooleanMischt die Reihenfolge der Spalten.false

Validierung

Ist required auf true gesetzt, muss der Teilnehmer pro Zeile eine Option auswählen.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als object (Record<string, string>) gespeichert, das jede Zeilenbeschriftung der ausgewählten Spaltenbeschriftung zuordnet:

json
{
  "Product Quality": "Excellent",
  "Customer Service": "Good",
  "Value for Money": "Average"
}

Matrix-Fragen werden auf dem Desktop als responsives Raster angezeigt und passen sich auf Mobilgeräten für bessere Bedienbarkeit einem gestapelten Format an. Zeilen und Spalten unterstützen unabhängige Zufallsreihenfolgen.

Liste

Erfasse mehrere Einträge derselben Art. Eine Liste enthält entweder einfache Textelemente (tippen und Enter drücken oder auf Hinzufügen tippen) oder wiederholbare Composite-Elemente — strukturierte Einträge auf Basis eines wiederverwendbaren Composites, etwa um beliebig viele Vorstandsmitglieder in einer einzigen Frage hinzuzufügen.

Typ-Bezeichner: list

Eigenschaften

EigenschaftTypBeschreibungStandard
itemTypestringstring für einfache Textelemente, composite für wiederholbare Composite-Instanzen.string
compositeIdstringDas referenzierte Composite (nur Composite-Elemente). Wird über die Auswahl gesetzt.
itemPlaceholderstringPlatzhaltertext für das Eingabefeld (Textelemente).
addButtonLabelstringEigene Beschriftung für die Hinzufügen-Schaltfläche in beiden Element-Modi.
minItemsnumberMinimale Anzahl an Elementen, die zum Absenden erforderlich ist.
maxItemsnumberMaximale Anzahl an Elementen. Harte Obergrenze 100.100
itemRegexstringValidierungsmuster pro Element (Textelemente).
itemRegexErrorstringFehlermeldung, wenn das Muster nicht erfüllt ist.
itemMinLengthnumberMinimale Zeichenanzahl pro Element (Textelemente).
itemMaxLengthnumberMaximale Zeichenanzahl pro Element (Textelemente).
allowDuplicatesbooleanErlaubt, dasselbe Textelement zweimal hinzuzufügen (Textelemente).true
allowReorderbooleanLässt Teilnehmer Elemente per Ziehen umsortieren (Textelemente).true
defaultItemsstring[]Beim ersten Laden der Frage vorbefüllte Elemente (Textelemente, Web-Formulare).[]
displayModestringWie ein eingeklappter Composite-Eintrag gerendert wird: compact (einzeilige Zusammenfassung) oder card (jede Feldbeschriftung + Wert).compact
compactFieldsstring[]Geordnete Unterfeld-IDs, die in der kompakten eingeklappten Zusammenfassung angezeigt werden. Standard ist das erste Feld des Composites.

Validierung

Ist required auf true gesetzt, muss mindestens ein Element hinzugefügt werden. minItems / maxItems werden beim Absenden durchgesetzt; Muster- und Längenregeln pro Element (Textelemente) werden beim Hinzufügen jedes Elements durchgesetzt.

Logiksprung-Operatoren

list_count_equals, list_count_greater_than, list_count_less_than, contains, not_contains, is_answered, is_not_answered

Die Zähloperatoren vergleichen gegen die Anzahl der Elemente in der Antwort.

Antwortformat

  • Textelemente: ein Array von Strings.
  • Composite-Elemente: ein Array von Objekten, jeweils mit Unterfeld-IDs als Schlüssel:
json
[
  { "sub_first_name": "Ada", "sub_email": "ada@example.com" },
  { "sub_first_name": "Grace", "sub_email": "grace@example.com" }
]

Jedes Composite-Element wird zusätzlich als eigenständiger Composite-Eintrag erfasst — siehe die Composites-Anleitung für die formularübergreifende Einträge-Ansicht und die eingeklappten Anzeigemodi.

Zuletzt aktualisiert: 15. September 2026