Field Settings

Each conditional field you create will have a number of settings. Some of these settings are required, and others require a certain format. These instructions will help you understand what each field is looking for.

  • Delete: To delete a field you no longer wish to use, click the checkbox near the word Delete in the section containing the unwanted field. Then click the Update Field button below.
    • Technical Note: The field will still exist in the database, and any previous orders containing this field will still display the deleted field’s data. Deleting a field simply prevents it from being displayed in the admin settings, and the order page. Also, clicking the Delete checkbox will clear the Product ID field, which prevents it from displaying on the checkout screen. Unchecking the delete box (before saving) will replace the Product ID(s). Do not re-populate this field if you intend on deleting it.
  • Sort Order: Use this field to control the order that your fields are displayed on the checkout page. Fields are ordered low to high, so a field with a sort order of 1 will show up first, and a field with a sort order of 2 will show up after that. Each field must have a unique number otherwise, the fields will not display correctly on the checkout page. By default all fields will start with a sort order equal to their field ID, however, you can change this order if necessary.
  • Disable Input: If you want to prevent customers from changing the text in the conditional field, check this box. For example, this can be used to display terms and conditions text as placeholder text in a text area.
  • Required Field: Set whether or not the field must be completed by a customer before checking out. If collecting information that is critical to the order, you should make the field required. Otherwise, if the order can be completed without the information you are asking for it is usually OK to make the field optional.
  • Error Message: This is the text that will be displayed to the customer if 1) Required Field is set to “Yes”, and 2) the customer does not complete the field. You may want to provide specific information to the customer telling them which field must be entered before they can complete their order.
  • Title (Required): This is the field that will be stored in the database along with your customer’s input. Without this field, the plugin will not be able to retrieve your customer’s input and you will likely only see the word “Array” where the input should be on the customer order.
  • Hide Title on Checkout: While the Title field is required for the plugin to function properly, it is not always desired (or needed) on the actual checkout page. Checking this box will hide the title from the checkout page so you can use other fields such as the Field Label, or Placeholder Text to describe what you are looking for in the field to the customer. The title you set will still display in the customer order email, the admin order edit page, and the customer order history/invoice page, so make the Title meaningful.
  • Products: Select the products that should be in the customer’s cart in order to display this conditional field. Tip: To temporarily prevent the conditional field from displaying, but to also retain the other settings, simply clear the options selected in this field.
  • Categories: Select the categories that should be in the customer’s cart in order to display this conditional field. Tip: To temporarily prevent the conditional field from displaying, but to also retain the other settings, simply clear the options selected in this field.
  • Input Type: There are nine different input types available. Please see the Input Types help document for more information.
  • Select Options: When using the Select Menu or Radio inputs, the options presented to the customer should be entered here. Each option must be entered on a separate line.
  • Field Label: This field is optional, but it provides a way for you to input additional text that you may not want to enter in the title field. This text can be used to provide instructions to the customer about how they should complete the field.
  • Placeholder Text: For text box and text area fields, you can enter placeholder text in the field as a guide to help customers fill in the field correctly. For example, if you are asking for a website address the placeholder text might be “http://www.example.com”. This is similar to the default text that is shown in the Order Notes box. For select menu fields, this will be set as the default option in the menu, which can indicate something like “Choose an option”. If the select menu field is set to be required, and the customer selects the placeholder option, it will trigger the error message.
  • Class: Allows you to set a custom class for the input so you can apply CSS styles to it if you choose to do so. This is optional, and usually not necessary.
  • Add to Order Email/Invoice: Select whether or not the information the customer enters should be added to the order email and/or order invoice. Some information may be critical to the order, as in the case of a customized product where the spelling of something might be important. If a customer can see this information in the order email/invoice, they may have enough time to contact you to correct any errors before the order is filled.