Form Field Limits

Forms and Payment Forms on eCatholic websites allow users to set submission limits, capping the number of form submissions at a specific amount. Within these forms, users can also set limits on specific fields.

Limits can be turned on for the following fields:

• Basic form fields - Select, Radio Buttons, and Replicator*
• Prebuilt form fields - Integer
• $ form fields - Amount Select, Amount Radio Buttons, Multiplier Integer, Multiplier Select, and Multiplier Radio Buttons

IN THIS ARTICLE:

Setting Field Limits

1. Drag and drop the desired field onto your form.
2. In the Basic tab for the field's settings, select On under Limit Quantity.
3. Click the + Add Option button.

4. In the resulting window, add an Option Name, an Option Amount (for Forms + Payments), and Limit. Click Save.

5. Options and limits will appear under the Field Options heading in the Basics tab. Click Save after adding your Field Options.

6. To edit field limits, hover over the field in question and click the gear icon
   1. Toggle On/Off the Limit Quantity.
   2. Delete individual Field Options by clicking the trash can.
   3. Change the default Field Option by clicking the check.
   4. Edit Option Amounts (for Forms + Payments), Option Names, and Limits by clicking the text.

Reaching Field Limit Capacity

For optional fields, visitors completing cannot make selections beyond what the field limit allows. For single-select fields - i.e. Select, Radio Buttons, Amount Select, Amount Radio Buttons, Multiplier Select, and Multiplier Radio Buttons - options that have reached the field limit can no longer be selected.

For fields where visitors select the quantity - i.e. Replicator, Integer, and Multiplier Integer - they are unable to enter a number higher than the field limit.

Fields with limits placed within a Replicator group will aggregate after the form is submitted, not after an option is selected. In the example below, both fields indicate that there are 25 tickets remaining for the 13-65 age range. Once this form - with its two 13-65 tickets - is submitted, the next submitter will see 23 tickets remaining for that age range.

Form Results and Field Limits

When using the Form Results Manager, some actions can impact the "remaining" amount for field limits while other actions cannot. See How to manage form results with the Form Results Manager for instructions on using the Form Results Manager.

Deleting form results - If a user deletes one or multiple form results in the Form Results Manager that contributed toward a field limit, the "remaining" amount for the field limits in question will automatically update to reflect the deleted form results. (e.g. If 5 spots were previously "remaining" but a user deletes a form result that had reserved 1 spot, the form will now show that 6 spots are "remaining.")

Editing form results - If a user edits form results in the Form Results Manager that contributed toward a field limit, the "remaining" amount for the field limits in question will NOT update to reflect the edited form results. (e.g. If 5 spots were previously "remaining" but a user edits a form result that had reserved 1 spot to now reserve 2 spots, the form will NOT show that only 4 spots are "remaining.")

Paying vs. Submitting for Forms + Payments

In the Forms module, the remaining field limits will automatically update when a visitor submits their form. However, for Forms + Payments, users can choose whether to count a visitor's form toward field limits upon completion of the form (regardless of payment) or only upon payment.

1. Click the gear icon for the Form + Payment in question.
2. Go to the $ tab.
3. Check the Require Payment field.
   1. If Require Payment is set to No, allow to pay later, the "remaining" amount for field limits automatically updates when the visitor submits the form - regardless of whether they have paid.
   2. If Require Payment is set to Yes, scroll to the Count Responses Toward Form Limits When field.
      1. If this field is toggled to Form is submitted (which is the default), the "remaining" amount for field limits updates when the visitor clicks the "Proceed to Payment" button on the form. (This allows them to reserve their selections while completing the payment portion.)
      2. If this field is toggled to Payment is complete, the "remaining" amount for field limits updates only once the visitor has successfully completed the payment.