NueForm

Création de formulaires

Learn how to create forms in NueForm, configure form settings, choose form modes, and set up welcome and thank-you screens.

Overview

NueForm lets you build beautiful, interactive forms that present one question at a time. This guide covers everything from creating your first form to configuring advanced settings like quiz modes and incremental submission.

NueForm Form Builder
The form builder interface with question list, preview, and settings panels.

Creating a New Form

To create a new form:

  1. Navigate to My Forms from the dashboard.
  2. Click the New Form button.
  3. Choose between a NueForm (standard form) or a Fuse (real-time collaborative activity).
  4. Give your form a title and optional description.
  5. Start adding questions from the question type palette.

Every form is automatically assigned a unique slug for its public URL. You can customize this slug at any time from the form settings.

Form Settings

Form Settings Panel
The form settings panel in the builder.

Basic Settings

SettingDescriptionDefault
TitleThe form's title, displayed in the dashboard and optionally on the welcome screen.Required
DescriptionAn optional description for internal reference.Empty
SlugThe URL path for your published form (e.g., nueform.io/f/my-survey). Must be unique.Auto-generated
Show Progress BarDisplays a progress bar showing how far the respondent has progressed.Enabled
Limit One ResponseRestricts each visitor to a single submission using browser-based visitor identification.Disabled
Incremental SubmissionSaves partial responses as the respondent progresses, so data is captured even if they abandon the form.Disabled

Welcome Screen

The welcome screen is the first thing respondents see when they open your form. Configure it with:

FieldDescriptionDefault
Welcome TitleThe heading displayed on the welcome screen. Leave empty to skip the welcome screen entirely.Empty (no welcome screen)
Welcome DescriptionSupporting text below the title. Supports rich text formatting.Empty
Welcome Button TextThe label for the button that starts the form."Start"

If you leave the Welcome Title empty, respondents will jump directly to the first question. This is useful for embedded forms or quick surveys.

Thank-You Screen

The thank-you screen appears after a respondent submits the form.

FieldDescriptionDefault
Thank You TitleThe heading displayed after submission."Thank you!"
Thank You DescriptionSupporting text below the title. Supports rich text formatting and variable substitution.Empty

You can use {variableName} syntax in the thank-you description to display personalized content based on the respondent's answers. See the Variables guide for details.

Form Modes

NueForm supports four distinct form modes, each designed for a different purpose. The mode is set at the form level and affects how answers are scored and how end screens behave.

Standard Mode

The default mode for surveys, contact forms, feedback collection, and any form that does not require scoring.

  • No scoring or grading.
  • Responses are collected and displayed as-is.
  • End screens are purely display-based.

Knowledge Quiz Mode

Designed for quizzes, tests, and assessments where there are correct and incorrect answers.

  • Each scorable question (multiple choice, dropdown, picture choice, yes/no, legal, opinion scale, rating) can have correct answers defined.
  • A correct answer score (default: 1 point) is awarded for each correct response.
  • Quiz feedback can be shown after each question with customizable messages.
  • The final score, number of correct answers, and total scorable questions are calculated and stored.

Quiz Settings:

SettingDescriptionDefault
Show Correct AnswersDisplays immediate feedback after each question telling the respondent if they were correct or incorrect.Enabled
Correct Feedback TextCustom message shown when the respondent answers correctly. Max 100 characters."Correct!"
Incorrect Feedback TextCustom message shown when the respondent answers incorrectly. Max 100 characters."Incorrect!"

Scoring Configuration (per question):

  • Correct Answers (correctAnswers): An array of choice IDs that constitute the correct answer. For single-answer questions, this contains one ID. For multi-select questions, all correct IDs must be selected.
  • Correct Answer Score (correctAnswerScore): Points awarded for a correct answer. Defaults to 1.

Lead Qualification Mode

Designed for lead scoring, personality assessments, and forms where different answers carry different point values.

  • Each choice in a scorable question is assigned a point value (choiceScores).
  • Points accumulate as the respondent progresses.
  • Multiple end screens can be configured with score ranges, and the respondent is routed to the appropriate end screen based on their total score.

Scoring Configuration (per question):

  • Choice Scores (choiceScores): A mapping of choice ID to point value. For example: { "choice_1": 10, "choice_2": 5, "choice_3": 0 }.

End Screen Configuration:

  • Each end_screen question can have a scoreRange property with min and max values.
  • After submission, the system matches the total score to the appropriate end screen.

Match Quiz Mode

Designed for personality quizzes, "Which character are you?" style forms, and outcome-based assessments.

  • Each choice maps to one or more end screen outcomes (choiceOutcomes).
  • As the respondent answers, tallies accumulate for each outcome.
  • The end screen with the highest tally is displayed.

Scoring Configuration (per question):

  • Choice Outcomes (choiceOutcomes): A mapping of choice ID to an array of end screen question IDs. For example: { "choice_1": ["end_screen_a", "end_screen_b"], "choice_2": ["end_screen_c"] }.

In all quiz modes, only scorable question types participate in scoring: Multiple Choice, Dropdown, Picture Choice, Yes/No, Legal, Opinion Scale, and Rating.

End Screen Questions

In quiz modes (knowledge, lead qualification, match), you can add multiple end_screen questions to your form. These act as conditional endings:

  • Knowledge Quiz: The end screen is selected based on the respondent's score.
  • Lead Qualification: Each end screen has a scoreRange (min/max), and the matching range determines which screen is shown.
  • Match Quiz: Each end screen accumulates tallies from choice outcomes, and the one with the highest tally wins.

End screen questions are placed in the question list but are not shown during the form flow. They only appear at the end, replacing the default thank-you screen.

Adding Questions

Questions are added from the Question Type Palette on the left side of the form builder. Questions are organized into categories:

  • Text: Short Text, Long Text, Email, Phone, Number, Website
  • Choice: Multiple Choice, Dropdown, Picture Choice, Yes/No
  • Rating: Rating, Opinion Scale, Net Promoter Score
  • Date: Date
  • Media: File Upload, Drawing, Video/Audio Recording, Signature
  • Layout: Statement, Welcome Screen, End Screen, Summary, Save Answers, Question Group, Multi-Question Page, Markdown
  • Advanced: Legal/Terms, Ranking, Matrix, Payment, Contact Info, Address

See the Question Types section for detailed documentation on each type.

Question Properties

Every question shares a set of common properties:

PropertyDescription
TitleThe question text displayed to the respondent. Supports rich text (bold, italic, underline, links) and {variable} substitution.
DescriptionOptional helper text shown below the title. Supports rich text and variable substitution.
RequiredWhether the respondent must answer this question before proceeding.
HiddenWhether the question is hidden from the respondent (useful for internal logic).
Custom Class NameAn optional CSS class name applied to the question container for custom styling.
Hide Question NumberRemoves the question number prefix (e.g., "1 ->") from the display.
TransitionThe animation used when transitioning to this question. Options: Vertical Slide (default), Horizontal Slide, Diagonal Slide, Elastic Bounce, Zoom Through, Rotate In.
Answer VariableStores the respondent's answer as a named variable for use in {variable} substitution in later questions.

Media Attachments

Every question supports optional media attachments. You can add images, videos, icons, or QR codes to any question.

Media Types:

TypeDescription
ImageUpload an image or provide an external URL. Supports brightness, contrast, saturation, hue rotation, and blur adjustments.
VideoEmbed a YouTube or Vimeo video with optional autoplay, muted, loop, and controls settings.
IconChoose from thousands of react-icons with customizable color.
QR CodeGenerate a QR code from a URL template that supports {variable} substitution.

Layout Options (Desktop):

LayoutDescription
stackMedia appears above the question content (default).
split-leftMedia on the left, question on the right, in a side-by-side layout.
split-rightMedia on the right, question on the left.
float-leftMedia floats to the left of the question text.
float-rightMedia floats to the right of the question text.
backgroundMedia appears as a background behind the question.
fullscreen-fitMedia fills the screen while maintaining aspect ratio.
fullscreen-coverMedia covers the entire screen, cropping as needed.

Layout Options (Mobile):

LayoutDescription
stackMedia appears above the question (default).
hiddenMedia is hidden on mobile devices.
backgroundMedia appears as a background.
fullscreen-fitMedia fills the screen while maintaining aspect ratio.
fullscreen-coverMedia covers the entire screen.

Image Adjustments:

AdjustmentRangeDefault
Brightness-100 to 1000
Contrast0 to 200100
Saturation0 to 200100
Hue Rotate0 to 360 degrees0
Blur0 to 20 px0

Focal Point: Set a focal point (0-1 normalized coordinates) to control which part of the image stays visible when cropped.

Slideshows

You can attach multiple media items to a single question to create a slideshow. Slideshow settings include:

SettingDescriptionDefault
DurationSeconds per slide.5
TransitionAnimation between slides: crossfade, slide, zoom, flip, ken-burns, blur-fade.crossfade
AutoplayAutomatically advance slides.Enabled
Show IndicatorsDisplay dot indicators below the slideshow.Enabled
Show ArrowsDisplay previous/next arrows.Disabled
Pause on HoverPause autoplay when the user hovers over the slideshow.Enabled

Question Ordering

Questions are displayed to respondents in the order they appear in the builder. You can reorder questions by dragging them in the question navigator panel on the left side of the builder.

Saving and Publishing

Forms are saved automatically as you make changes. To make a form available to respondents, you must publish it. See the Publishing guide for details on the publishing workflow.

Dernière mise à jour : 6 avril 2026