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
-
Navigate to the HubSpot App Marketplace and search for Limit Form Submissions.
-
Click Install App.
-
Choose the HubSpot portal you wish to connect.
-
Review the requested permissions and click Connect App.
-
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:
-
In your HubSpot account, click the Marketplace icon in the top navigation bar.
-
Select Connected Apps.
-
Find Limit Form Submissions in your list of apps and click on it.
-
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:
-
Select Form: Choose your desired HubSpot form from the dropdown list.
-
Set Max Submissions: Enter the total number of submissions allowed before the form should close (e.g., 50).
-
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!”).
-
Activate: Toggle the Active switch to “On.”
-
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:
-
Within the app settings for your selected form, click the Embed Code button.
-
Copy the provided JavaScript snippet.
-
Navigate to the webpage where your HubSpot form is hosted.
-
Paste the Limit Form Submissions snippet directly underneath your existing HubSpot Form embed code.
-
Save and publish your page.
Step 5: Test Your Form
We recommend performing a quick test to ensure the automation is active:
-
Temporarily set your Max Submissions to 1 in the app settings and click Save.
-
Visit your live website and submit the form once.
-
Refresh the page. You should now see your Custom Limit Message appearing in place of the form.
-
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.