Setup Guide

Prerequisites

Before you begin, ensure you have:

  • A HubSpot account with App Marketplace permissions.

  • An existing HubSpot Form created in your portal.

  • Access to the HTML/CMS of your website where the form is embedded.


Step 1: Install and Connect the App

  1. Navigate to the HubSpot App Marketplace and search for Limit Form Submissions.

  2. Click Install App.

  3. Choose the HubSpot portal you wish to connect.

  4. Review the requested permissions and click Connect App.

  5. You will be redirected to a confirmation page once the connection is successful.


Step 2: Access the App Settings

Once installed, the app configuration is managed within your HubSpot portal:

  1. In your HubSpot account, click the Marketplace icon in the top navigation bar.

  2. Select Connected Apps.

  3. Find Limit Form Submissions in your list of apps and click on it.

  4. Navigate to the Settings tab within the app interface.


Step 3: Configure Your Form Limits

For each form you wish to control, follow these steps:

  1. Select Form: Choose your desired HubSpot form from the dropdown list.

  2. Set Max Submissions: Enter the total number of submissions allowed before the form should close (e.g., 50).

  3. Customize Your Message: In the “Limit Message” field, type the text you want users to see once the limit is reached (e.g., “Sorry, this event is now full!”).

  4. Activate: Toggle the Active switch to “On.”

  5. Save: Click the Save button to store your configuration.


Step 4: Embed the Script on Your Website

To enable the “kill switch” on your external website or HubSpot page:

  1. Within the app settings for your selected form, click the Embed Code button.

  2. Copy the provided JavaScript snippet.

  3. Navigate to the webpage where your HubSpot form is hosted.

  4. Paste the Limit Form Submissions snippet directly underneath your existing HubSpot Form embed code.

  5. Save and publish your page.


Step 5: Test Your Form

We recommend performing a quick test to ensure the automation is active:

  1. Temporarily set your Max Submissions to 1 in the app settings and click Save.

  2. Visit your live website and submit the form once.

  3. Refresh the page. You should now see your Custom Limit Message appearing in place of the form.

  4. Once confirmed, return to the app and update the Max Submissions to your actual desired limit.


Troubleshooting & Support

  • Message not appearing? Ensure the script is placed exactly below the HubSpot form embed code and that the “Active” toggle is On.

  • Submissions exceeding limit? Remember that there may be a slight delay in sync (usually less than a few seconds) if multiple users submit at the exact same millisecond.

  • Need help? Contact us at dino@incodestudios.co.uk


Quick Tips for Success:

  • Styling: Your limit message will inherit the basic CSS of your website’s body text.

  • Updates: You can change your limits at any time without needing to update the embed code on your site; the script will fetch your new settings automatically.