đ Overview
The Embed Form is a lead form you set up in Structur and add to your own website. When a visitor fills it out, Structur creates a new lead in your Leads pipeline, adds the visitor as a client, and lets your team know.
It's separate from Intake, the form your team fills out inside each lead during the first call. Answers from your website fill in the lead's details on Overview, not Intake. See the Intake Form article for that form.
đ Understanding the Embed Form
⥠What It Does
The Embed Form allows you and your team to:
Turn website inquiries into leads -- each submission creates a lead in the stage you choose
Create the client automatically -- from the visitor's name, email and phone
Alert the right people -- pick the users who hear about each new website lead
Choose the questions your website asks -- in the Form Builder, and decide which project field each answer fills in
Match your brand -- with your own font size and colors
đ When to Use It
The Embed Form is most valuable when you want to:
Get website inquiries into Structur without retyping them
Make sure the right salesperson hears about every new inquiry
Collect the basics before your first call with a new lead
đ Step-by-Step Instructions
1. Open the Embed Form
Click Leads in the left sidebar
Click Embed Form in the top bar, just left of Settings
The Manage embedded Lead form window opens. The lead settings and design options are at the top, with the Form Builder and Embed Code tabs below them.
Note: The Embed Form button is only on the Leads page, not on the Projects page. Who can change the form is set by the Embed Form row under Preconstruction in Settings > Permissions.
2. Choose Where New Leads Go
Under Default Stage for New Leads, pick the stage new website leads start in. It's New Lead unless you change it
Under Redirect URL, enter the page visitors see after they submit, such as your thank-you page
Under Send notifications to, pick the users who should hear about each new website lead. You can pick more than one
Leave Trigger webhook when a new Lead is created off unless your company sends new leads to another system
Note: Enter the Redirect URL as a full address starting with https://, for example https://www.yourcompany.com/thank-you. Currently, an address without https:// isn't rejected, and visitors land on a Structur page instead of your site. For example, "yourcompany.com/thanks" sends them to app.structur.com/yourcompany.com/thanks.
Note: Send notifications to lists the users in your company. Groups aren't offered. Each person also controls this alert for themselves in Settings > Notifications, under Leads, as New lead from embed form. Make sure Email is on there for anyone who should get the email.
3. Style the Form
Set the Font Size to Small, Normal or Large. Click the Font Color and Submit Button Color swatches to pick colors. The color picker takes a HEX code, so you can match your brand colors exactly.
Note: The window doesn't show a preview. Check the look on your website once the form is live.
4. Review the Form Questions
Click the Form Builder tab. It lists the questions on your form, in order. Each question has a drag handle to move it, a pencil to edit it and a trash icon to delete it, and + New Field at the top right adds a question.
A new form starts with these questions:
What type of project is this? (Residential, Commercial, Industrial, Multifamily or Other)
About how many Square Feet?
Do you already have an Architect?
Brief project description
Do you have a project address?
What is your name? (required)
What is your email address? (required)
What is the name of your project? (required)
What is your phone number?
Do you have any Files to share? (an Upload file button)
Required questions show a red asterisk in the Form Builder.
Note: Structur names the lead from the project name and creates the client from the name, email and phone. Keep those questions on your form.
5. Add or Edit a Question
In the Form Builder tab, click + New Field, or click the pencil on a question to change it
Pick a Field Type: Short Text, Long Text, Email, Phone, File, Number, Date, Currency, Single Option, Multiple Options, Dropdown, Yes / No or Rich Text
Enter the Title, the question your visitors see. Add Placeholder Text and a Subtitle if you want them
Under Map to Project Field, pick where the answer goes: Project Name, Project Description, Client Name, Client Email, Client Phone, Project Address, Project Type or Other
Tick This is a required field if visitors must answer it
Click Add Field for a new question, or Update Field when you're editing one
Field Type, Title and Map to Project Field are required. Click Close to leave without saving.
Important: Each project field keeps only one answer. If two questions map to the same field, for example two phone questions both mapped to Client Phone, only one answer is kept and the other is lost. Map each question to a different field, or to Other. Currently, answers mapped to Other don't show on the lead.
6. Add the Form to Your Website
Click Copy Embed Code at the bottom left of the window. You'll see "Embed code copied to clipboard"
Click Done to close the window
In your website builder, add an HTML, code or embed block where you want the form
Paste the code into that block, then save and publish your page
You can also open the Embed Code tab to see the same code under HTML Embed Code.
Note: Paste the whole code into a block made for HTML or code, not into a link or URL field. The code has two parts: the form, and a short script that sends visitors to your Redirect URL. If your website builder strips out the script, visitors may stay on the form after they submit.
Note: If the form has been on your website for a while, copy the code again and replace the old code once, so your site has the latest version.
7. What Your Visitors See
Visitors see your questions, an Upload file button for files, and a Submit button. Above Submit, a Cloudflare check runs and shows a green tick with Success! for a normal visitor.
If a visitor leaves a required question empty, their browser shows "Please fill out this field." and they can't submit until they fill it in.
8. What Happens When Someone Submits
Each submission:
Creates a lead in your Leads pipeline, in your Default Stage for New Leads
Names the lead from "What is the name of your project?", and fills in its Address, Description and Project Type from the matching questions
Creates a client in Settings > Clients from the visitor's name, email and phone, and sets them as the lead's Client. If a client with that email already exists, Structur uses that client instead of creating a second one
Adds a Recent Activity entry such as "Jane Smith submitted the opportunity from an embedded form."
Sends a New Lead notification: "A new lead named Smith Kitchen Remodel was created from the embedded form."
Sends the visitor to your Redirect URL, if you set one
Note: A file uploaded on the form isn't added to the lead's Files. Currently, answers mapped to Other and uploaded files don't show anywhere on the lead.
Note: Website answers don't fill in Intake. A website lead's Intake starts empty and locked, ready for your first call.
Note: Lead Source and the team fields, such as Sales Rep(s) and Estimator(s), are left blank. Fill them in on the lead's Overview when you pick up the lead: click Edit in Project Details, and Manage Members for the team.
9. Test the Form
Before you share the page, fill out the form on your website once yourself with a test name and email. Check that:
The lead appears in the stage you chose
Each answer lands where you expect on the lead's Overview
You land on your Redirect URL
The right people get notified
Then delete the test lead: click Actions in its header, then Delete.
â Best Practices
Use a full https:// address for the Redirect URL -- an address without it can send your visitors to the wrong page.
Send a test submission before you go live -- it's the only way to see where each answer lands and who gets notified.
Check Map to Project Field on every question -- two questions on one field means one answer is silently dropped.
Add the people who follow up to Send notifications to -- a website lead nobody hears about goes cold fast.
Keep the website form short -- ask for what you need to call them back, and save the detailed questions for Intake on the first call.
Paste the full code into an HTML or code block -- a link field breaks the form, and losing the script breaks the redirect.
Read the lead's Overview first on website leads -- the visitor's answers fill in the lead's details, so you don't ask them again.
Set Lead Source when you pick up a website lead -- it arrives blank, so your lead source reporting undercounts your website otherwise.
Re-copy the code if your form has been up a while -- the current code includes the latest version of the redirect script.
â Common Questions
Q: What's the difference between the Embed Form and Intake?
A: The Embed Form is the public form on your website. It creates a lead when a visitor submits it. Intake is an internal form inside each lead and project that your team fills out during the first call. Website answers never appear in Intake, and a website lead's Intake starts empty. See the Intake Form article.
Q: A lead came in from our website. Where are their answers?
A: The project name, address, description and project type fill in the lead's details. The name, email and phone go on the client. Currently, answers mapped to Other, and any files the visitor uploaded, don't show on the lead. Uploaded files aren't in the lead's Files either.
Q: Why is one of the visitor's answers missing from the lead?
A: Two questions are probably mapped to the same project field, and only one answer is kept per field. In the Form Builder, click the pencil on each question and check Map to Project Field, including the default questions. Give each question its own field. Currently, answers mapped to Other are not shown on the lead.
Q: Someone on my team didn't get the new lead email. Why?
A: Check two things. First, that they're picked under Send notifications to in the Embed Form window. Second, that Email is on for New lead from embed form in their own Settings > Notifications, under Leads.
Q: Does the form stop spam?
A: Every submission goes through a Cloudflare check, shown above the Submit button. Most visitors just see a green tick and Success!. If junk leads still get through, delete them and contact support.
Q: Can I have more than one embed form?
A: The Embed Form window manages one form for your company. To sort different kinds of inquiries, use a question such as "What type of project is this?" and check the answer on each lead.
Q: Why does Recent Activity show my avatar on a website lead?
A: The entry names the visitor ("Jane Smith submitted the opportunity from an embedded form."), but it's shown with the account owner's avatar. To mark website leads clearly, set their Lead Source with Edit in Project Details on the lead's Overview.
Q: Can other tools, like Facebook lead ads, send leads into Structur?
A: Currently, no. The webhook only sends new website leads out of Structur. To capture leads from an ad, point the ad at a page on your website that has the Embed Form.
Q: Who can change the Embed Form?
A: Anyone whose role has access on the Embed Form row under Preconstruction in Settings > Permissions. Full access covers editing the questions and managing the settings.
â ď¸ Common Mistakes to Avoid
â Don't | â Do |
Look for website answers in Intake | Check the lead's Overview |
Enter a Redirect URL like "yourcompany.com/thanks" | Enter the full address: "https://yourcompany.com/thanks" |
Paste the code into a link or URL field | Paste it into an HTML, code or embed block |
Map two questions to the same project field | Give each question its own field |
Leave Send notifications to empty and hope someone notices | Pick the people who follow up on new leads |
Go live without a test submission | Submit once yourself and check the lead, the client and the notification |
Leave website leads with no Lead Source | Set Lead Source on Overview when you pick up the lead |
