Create & Manage Environments

Prev Next

By default, your account has one environment, this is your Production environment. This article will show you how to create a new environment as well as clone, edit, or delete existing environments.

Create an Environment

  1. Sign in to your site

  2. Navigate to Advanced Tools and select Environments The Advanced Tools dropdown and Environments option.

  3. Click the + (plus sign) icon in the bottom-right corner of the screen The green, circular Create New Environment button.

  4. Fill in the New Environment information fields The New Environment Modal information fields.

    • Name (required): Enter a name for the new environment

    • Description: Enter a description for the new environment

    • App's URL Suffix (required): This field will automatically populate based on the name of the environment (this can be edited after the environment is saved)

    • Notification Email Addresses (required): Enter any email addresses that you wish to be notified of events such as user access requests and failed workflow events

  5. Click Save The green, rectangular Save Change button in the lower-right corner of the New Environment modal.

  6. You can now edit the settings and appearance of the environment

Edit an Environment

  1. Sign in to your site

  2. Navigate to Advanced Tools and select Environments The Advanced Tools dropdown and Environments option.

  3. Click the name of the environment you wish to edit An example environment name.

  4. Navigate to the Settings tab to customize the name, standard settings, and email addresses for the environment, if desired The Environments Settings tab and information fields.

    • Environment Name: Click the name of the environment to edit the name

    • Standard Settings

      • Description: Add or edit a short description of the environment

      • App's URL Suffix (required): Edit the environment's URL suffix as desired

        Notes:

        • This field will automatically populate based on the name of the environment.

        • We recommend keeping the URL as short as possible; use abbreviations if necessary. Too long of a URL may cause issues with rendering.

      • Custom Domain: Select the globe icon to set a custom domain for your environment. Automation - Environment - Set Custom Domain.png

    • Email Sending: Customize the sending email address for any out-of-the-box emails that are sent using your app in the environment. When configuring an email address, a verification email with a link will be sent to the listed email address. These links last 24 hours. If the link has expired, you can resend the verification email. Once the link has been clicked, thereby verifying the email address, any new emails sent from the app will be sent using your new sending email address.

      Note: The email sending address is used for all apps in the environment. This email can be overwritten by configuring a different email sending address in your app.

    • Notifications (required): Add or remove email addresses that you wish to be notified of events, such as user access requests and failed workflow events. The email address is prepopulated with the Team Member who created the environment, but any email address can be added.

  5. Click Save to save your changes The green, rectangular Save button below the User Menu.

  6. Navigate to the Appearance tab to modify the default appearance of apps and forms within this environment, if desired The Appearance tab fields for an environment.

    Note: The Appearance tab allows you to customize the appearance of the apps and forms within the environment. These options are automatically inherited by all forms and apps. If you would like your app to have different appearance configurations, you can overwrite all of these configurations by updating the configurations on the Builder screen of an App.

    • App Banner Image: Add or update the default custom banner image used by the apps in this environment

    • Color Theme: Customize the default colors displayed in the apps and emails in this environment.

    • Favicon: Customise the favicon displayed in apps and appless forms in this environment.

    • Validation Error Icon: Customize the icon displayed alongside validation errors in forms in this environment.

    • Buttons: Customize the default label and icon displayed for buttons in your apps in this environment.

  7. Click Save to save your changes The green, rectangular Save button below the User Menu.

  8. Navigate to the Developer Tools tab to apply advanced styling and settings to the environment, if desired The Environments Developer Tools tab and information fields.

    • Advanced Styling: Customize the CSS for the apps in this environment

      Note: You can also set advanced styling at the app level.

    • ReCAPTCHA: Select your own ReCAPTCHA key to use when embedding forms in your own website, or when using a custom domain.

    • Google Maps Key: Select your own Google Maps key to use when embedding forms in your own website.

  9. Click Save to save your changes The green, rectangular Save button below the User Menu.

  10. The environment has been updated

Clone an Environment

  1. Sign in to your site

  2. Navigate to Advanced Tools and select Environments The Advanced Tools dropdown and Environments option.

  3. Click the Clone Environment button next to the environment you wish to copy The Clone Environment button to the right of an example environment.

  4. Fill in the New Environment information fields The New Environment information fields.

    • Name (required): Enter a name for the new environment

    • Description: Enter a description for the new environment

    • App's URL Suffix (required): This field will automatically populate based on the name of the environment (this can be edited after the environment is saved)

    • Notification Email Addresses (required): Enter any email addresses that you wish to be notified of events such as user access requests and failed workflow events

  5. Check the checkboxes for the features you would like to be cloned into your new environment Features checkboxes.

  6. Click Save to save your changes The green, rectangular Save Change button in the lower-right corner of the New Environment modal.

  7. The environment has been cloned

Delete an Environment

Important Notes

  • Deleting an environment will delete all of its forms, info pages, and apps.

  • You cannot delete the Default (Production) Environment.

  • This is a permanent action and cannot be undone.

  1. Sign in to your site

  2. Navigate to Advanced Tools and select Environments The Advanced Tools dropdown and Environments option.

  3. Click Delete Environment (trash can icon) to the right of the environment you wish to remove The Delete Environment button.

  4. Click Delete on the pop-up that appears to confirm the deletion The green, rectangular Delete button on the Delete Environment popup.

  5. The environment has been deleted