Email Input

This article explains the features of the Email Input block and how it can be used to design your app.

Use Cases

1. Collecting Contact Information: Gather users' email addresses for communication or registration.
2. Subscription Forms: Capture email addresses for newsletter subscriptions or marketing updates.
3. Customer Support: Collect emails from users for follow-up on support requests or inquiries.

Editing the Block

Click on the Email Input block and start editing on the panel that appears on the right side.

‍

Label

The label is the name of the block that the end user sees in the app.

Example: Email Address

Description

The description is the additional information provided to the end user, displayed below the input area. You can also leave this blank if not necessary.

Example: Please enter your email address.

Default Value

Set a default email that will appear in the field when the app loads. This can act as a placeholder or sample email for users.

Example: example@email.com

Required

Enable this option if you want to make this field mandatory. When enabled, users must enter a valid email address in this field before submitting the form or else they will not be able to submit.

Advanced Options

Display this field if

Use this option to show or hide the field under specific conditions. It accepts the standard Clappia formulae, similar to conditional sections or in the ‘Calculations & Logic’ block.

1. Type @ to get a list of all the fields you have added in the app and select the relevant field or type @ followed by the field name.

2. Use these field variables to write spreadsheet-like formulae for conditional display of the field in the app.

Retain value if hidden

This option appears once a condition is set in the Display this field if option. Enable this setting if you want the field's value to be retained even when the field is hidden. This is useful for preserving user input in cases where the field may temporarily disappear based on conditions.

Example: If the field is hidden based on user selection but you still need to keep the entered value for future reference or calculations, enable this option to ensure the data is retained.

Allow value to be changed after initial submission

This option is enabled by default. When active, end users can edit the email address entered in this field after creating a submission. Disable this option if you want the initial email to remain unchangeable once submitted.

Block Width

Desktop View: Set the width of the PDF Viewer block in the desktop view. Options are 100%, 75%, 50%, or 25%.

Mobile View: Set the width of the PDF Viewer block in the mobile view. Options are 100% or 50%.

Variable Name

This is the unique identifier for the Email Input field, which can be used in formulas or references within the app. This appears automatically after saving your configuration of the Email Input block.

Using the Block in App Home

In App Home, users can input their email addresses in the Email Input field. If an invalid email address is entered, an error message will appear, prompting the user to correct the format. The block accepts only valid email formats, ensuring data accuracy.