When to Use This Article: Use this guide if your site uses FormAssembly for forms. If you're using Gravity Forms instead, see Gravity Forms documentation.


TABLE OF CONTENTS


About FormAssembly

FormAssembly is a powerful form builder that integrates with your WordPress site through a plugin. It's particularly useful for:

  • Complex forms with conditional logic
  • Forms that connect to Salesforce or other CRM systems
  • Registration forms with payment processing
  • Forms requiring advanced data validation or workflows


Prerequisites

Before embedding a form, make sure:

1. Verify the FormAssembly Plugin is Active

  1. Log in to your WordPress admin panel
  2. Navigate to Plugins in the left sidebar
  3. Look for "FormAssembly" in your installed plugins list
  4. The plugin status should show "Active" (usually in green or blue text)

If the plugin is not installed or active: Contact Gameflow support to activate it for your site.


How to Embed a FormAssembly Form

Step 1: Create Your Form in FormAssembly

  1. Log in to your FormAssembly account
  2. Build your form using FormAssembly's form builder
  3. Test your form to ensure it's working correctly
  4. Publish the form in FormAssembly

Step 2: Get Your Form ID

  1. In FormAssembly, find your form in the Forms list
  2. Look for the Form ID number - it appears above the form title and looks like a number (e.g., 4715407)
  3. Copy this number - you'll need it in the next step

FormAssembly Form ID location

The Form ID appears above your form title in FormAssembly.


Step 3: Add the Form to Your WordPress Page

Basic Shortcode Format

  • FormAssembly Basic, Professional, & Premier plans (tfaforms.com):
    [formassembly formid=123456]


  1. In WordPress, go to Pages and create a new page or edit an existing one
  2. In the page editor, create or select a tab where you want the form to appear
  3. Add a Content Block field for that tab
  4. Switch to the Text editor view (not Visual editor)
  5. Paste your shortcode (see above)
  6. Make sure the shortcode is on its own line with no extra spaces

Advanced Shortcode Options

Display form in an iframe:
If you experience styling conflicts between your site and the form, or if your server doesn't support the default publishing method, use the iframe option:

[formassembly formid=123456 iframe=1]

Control form size with custom CSS:
You can add CSS styling to control the form or iframe dimensions:

[formassembly formid=123456 iframe=1 style="width: 100% !important;"]


Step 4: Publish and Test

  1. Click Update or Publish to save your page
  2. View the page on your live site
  3. Test the form by filling it out and submitting it
  4. Verify the submission appears in FormAssembly

Troubleshooting Common Issues

Form Doesn't Appear

Possible causes:

  • Plugin not active: Verify FormAssembly plugin is activated (see Prerequisites above)
  • Wrong Form ID: Double-check you copied the correct Form ID from FormAssembly
  • Wrong plan type shortcode: Make sure you're using the correct shortcode format for your FormAssembly plan (Basic/Professional).  If you're on an Essentials/Team/Enterprise or Government plan, contact Gameflow for support.
  • Shortcode in Visual editor: Make sure you pasted the shortcode in Text editor mode, not Visual mode
  • Extra characters: Ensure no spaces or extra characters around the form ID number. Use formid=123456 not formid='123456' or formid="123456"

Form Appears But Doesn't Submit

Possible causes:

  • Form not published in FormAssembly: Check that your form is published (not in draft mode) in FormAssembly
  • FormAssembly account issue: Verify your FormAssembly account is active and the form is not disabled

Form Looks Wrong or Styling is Off

Solutions:

  • Try iframe mode: Add iframe=1 to your shortcode to isolate the form styling from your WordPress theme
  • Check FormAssembly theme: Review your form's theme settings in FormAssembly - you may need to adjust colors to match your site
  • Width issues: Use the style parameter to control form width: style="width: 100% !important;" or style="width: 600px !important;"
  • Some custom CSS on your WordPress site may interfere with form styling. Contact Gameflow support if styling issues persist.

Best Practices

  • Test before going live: Always test your form on a staging or preview version before publishing
  • Set up notifications: Configure email notifications in FormAssembly so you know when forms are submitted
  • Check mobile display: View your form on a mobile device to ensure it displays correctly

Additional Resources

Need Help?

If you're still having trouble embedding your FormAssembly form, contact Gameflow support by submitting a ticket on this page.