--- title: "Form Widgets" slug: "form-widgets" tags: ["forms"] updated: 2023-08-15T19:57:36Z published: 2023-08-15T19:57:36Z canonical: "support.smarteru.com/form-widgets" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.smarteru.com/llms.txt > Use this file to discover all available pages before exploring further. # Form Widgets The available form widgets and their settings are described below. ## Attachment The Attachment widgets enables the recipient to [upload and submit files with the form](https://support.smarteru.com/v1/docs/smarteru-file-uploads-1#forms). ![Attachment Widget](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-5y59x8mf.png) Refer to [SmarterU File Uploads](https://support.smarteru.com/docs/smarteru-file-uploads-1#attachments) for file specifications.   You can edit the Attachment widget's settings that are listed below. ![Attachment Settings](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-qsk1z0jx.png) You'll need to click the ![Gear](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-tunsquur.png)to access some of the settings below. ### Text The instructions that display above the controls for the Attachment widget. ### Status If enabled, the widget displays on the form. By default, the Form Builder only displays active widgets. However, you can include inactive widgets in the preview. ### Required If enabled, the learner must upload at least one attachment before they can submit the form. ### Restrict Number of Files If enabled, you can limit the number of files that the learner can upload to the form. ### Files This setting is only available when the [**Restrict Number of Files** setting](/v1/docs/form-widgets#restrict-number-of-files) is enabled. Enter the maximum number of files a learner can upload to the form. ### Prompt for Comment If enabled, an additional field displays where the learner can enter text about the attachment. ![Comment Field](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-7nbvrn4k.png) ### Required If checked, the learner must enter a comment for the attachment before they can submit the form. --- ## Divider The Divider widget inserts a horizontal line in the form. ![Divider](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-uf3ixmay.png) The Divider widget does not have settings. --- ## Header The Header widget inserts a title in a form. ![Header](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-d5y3ykk2.png) You can [edit the Header widget's text](/v1/docs/editing-a-form-widgets-settings) to provide a title. ![Header Settings](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-wj1tf5pw.png) --- ## Image The Image widget inserts the selected graphic in the form. ![Image](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-mg2tdsjp.png) You can [edit the Image widget's settings](/v1/docs/editing-a-form-widgets-settings) that are listed below. ![Image Settings](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-g1woe9im.png) ### Upload an Image To upload a graphic file, click **Upload File**. ### Display Options Select how you would like the image to display on the form: - Centered Short - Horizontally centers the image at 30% of the learner's screen height using the image's original aspect ratio. ![Centered Short](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-98y1kz4i.png) - Centered Tall - Horizontally centers the image at 50% of the learner's screen height using the image's original aspect ratio. ![Centered Tall](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-ti4u6ysc.png) - Banner Short - Displays the image at 30% of the learner's screen height using the full width of the form. ![Banner Short](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-i3nc4h7a.png) - Banner Tall - Displays the image at 50% of the learner's screen height using the full width of the form. ![Banner Tall](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-9vp7vnin.png) ### Title A name for the image. ### Alt Text The alternate text that describes the image or its functionality. --- ## Question The Question widget inserts a multiple choice question in the form. ![Question](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-06lfa74l.png) You can edit the Question widget's settings that are listed below. ![Question Settings](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-hasje1rm.png) You'll need to click the ![Gear](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-7bainswy.png)to access some of the settings below.   ### Text The question text. ### Options The responses to the question. To change the text displayed, click the text and edit it as needed. To reorder the options, click the ![](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-ozawxp89.png) and drag the option to its new position. If the ![](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-jmpe21za.png) has focus, you can also use your up and down arrow keys to change the option's position. When you're ready to drop the option, press the spacebar. To remove an option from the question, click the ![](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-vk0e61c9.png). ### Status If enabled, the widget displays on the form. By default, the Form Builder only displays active widgets. However, you can include inactive widgets in the preview.   ### Required If enabled, the learner must select an option before they can submit the form. ### Orientation Select how the options display on the form: - Horizontally - The options display from left to right. ![Options Horizontal](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-fcr287ys.png) - Vertically - The options display from top to bottom. ![Options Vertical](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-fvgbx5x9.png) ### Enable Multi-Select If enabled, learners can select more than one option for the question. ### Prompt for Comment If enabled, an additional field displays where the learner can enter text about the question. ![Comment Field](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-hjbn8a1u.png) ### Required If checked, the learner must enter a comment for the question before they can submit the form. --- ## Text The Text widget inserts content in the form. ![Text](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-z8oz2eo6.png) You can [edit the Text widget's settings](/v1/docs/editing-a-form-widgets-settings) to include content such as instructions or other information in the form. ![Text Settings](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-t3cqzyl0.png) --- ## Text Response The Text Response widget inserts a text field in the form. ![](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-oltjyo0l.png) You can [edit the Text Response widget's settings](/v1/docs/editing-a-form-widgets-settings) to include instructions in the form. ![Text Response Settings](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-jbgu50yk.png) --- ## Video The Video widget inserts a video in the form. ![Widget Video](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-eopjc2xd.png) You can [edit the Video widget's settings](/v1/docs/editing-a-form-widgets-settings) that are listed below. ![Video Settings](https://cdn.document360.io/7efaadab-fef6-4186-806a-2ca14c9ce9ea/Images/Documentation/form-widgets-image-4h45r5sz.png) ### Type Select one of the following options: - Upload - You would like to upload the video's file. - Embed - You would like to embed code to access media that's been uploaded to another site. ### Upload a Video This setting is only available when the [**Type**](/v1/docs/form-widgets#type) is set to *Upload*. To upload a video file, click **Upload File**. ### Embed Code This setting is only available when the [**Type**](/v1/docs/form-widgets#type) is set to Embed. Enter the embed code for the video. ### Description A description of the video. ## Related - [Adding a Widget to a Form](/adding-a-widget-to-a-form.md) - [Editing a Form Widget's Settings](/editing-a-form-widgets-settings.md) - [Form Builder](/form-builder.md) - [Learner Interface: Forms](/learner-interface-forms.md)