Gravity Forms Shortcode Explained

Posted on January 18, 2011

This post is about Gravity Forms, a WordPress contact form plugin.

I know about Gravity Forms…but what are shortcodes?

Think of shortcodes as a placeholder for where other content will be displayed: instead of “Insert a Gravity Forms form here,” we use the gravityform shortcode. Learn more about shortcodes on WordPress.org.

The Gravity Forms shortcode has five pieces:

[gravityform id=# name=TEXT title=boolean description=boolean ajax=boolean]

  1. id (required) – The ID of the form, as displayed on the Gravity Forms Edit Forms page in the Id column
  2. name (required) - The name of the form.
  3. title – Show the title to users? Default is true; set to “false” to disable
  4. description – Show the form’s description to users? Default is true; set to “false” to disable.
  5. ajax – Submit the form without refreshing? Default is false; set to “true” to enable.

Gravity Forms Shortcode Examples:

[gravityform id=1 name=Example Form title=false description=false ajax=true]
Will result in Form #1 being displayed without a title or description, with no-refresh entry submission.

The shortcode above could be read as: “Insert Gravity Forms Form #1 here. Do not show the title or description. The form should use Ajax to submit entries.”

[gravityform id=2 name=Another Form]
Will result in Form #2 being displayed. The title and description will be displayed (they are true by default), and entries will require a page-load (ajax is off by default).

[gravityform id=3 name=Yet Another Form description=false ajax=true]
Will result in Form #3 being displayed. The title will be displayed, but the description will not. Entries will not require a page-load (ajax is turned on).

Any questions?

This post has been created to make explicitly clear how the Gravity Forms shortcode works. If you have any unanswered questions, please leave them in the comments below and they will be answered.

An (advanced) note about custom Gravity Forms shortcode attributes:

In Version 1.6.5 of Gravity Forms, a feature was added to allow for custom shortcode attributes to be added by other Gravity Forms add-on plugins. This means that there may be more pieces to the shortcode in the future!

This entry was posted in Tutorial, WordPress and tagged , , , , . Bookmark the permalink.
  • Luca Giorcelli

    Thanks.

    I didn’t succeded in finding the same informations on gravity web site

  • http://handsonbristol.gaiaphon.com Toni Massari

    Hey there! I have had to uninstall plugins from my WordPress blog because the CKEditor turned the shortcodes into literal text. I tried temporarily deactivating CK Editor (which kinda hurt, because it took an Ice Age to get it working correctly with CKFinder!) and activated the plugins I wanted on the site (A Business Directory and Contact Form) but then had problems with fonts and display.

    Is there a way ’round this?
    Cheers!

  • Janell

    When I use the [directory] short code, I can’t specify which form I want the entries to come from. It defaults to the first one. How do I specify which form I want? Also, when I click on the “add a gravity forms directory” icon in the WYSIWYG editor, it does nothing.

    • http://www.seodenver.com Zack Katz

      Use [directory form="#"] where # is the form id.

      What browser are you using? Does e Insert Directory error occur when you disable all other plugins except Gravity Forms and this one?

  • http://www.dmcommun.com LAN cabling

    Brilliant article bro. This unique is just a totally nicely structured posting, just the important information I was hunting regarding. Cheers

  • http://www.tourismdentalindia.com Dental Tourism

    Thanks I needed these urgently. 

  • http://designstutorial.com/ Web Design Blog

    thanks, this info was really very helpful. 

  • http://www.brandonkraft.com/ Brandon Kraft

    Don’t forget about the field_values attribute. If you have fields set to dynamically populate, you can use it in the style of

    Oops! We could not locate your form.

    , etc.

  • Cata

    thanks

  • ronald

    I was looking for shordcodes which show the entry lists in the front Page/ or home
    please reply me

    • http://www.seodenver.com Zack Katz

      There’s no shortcode for that unless you use Gravity Forms Directory.

  • Arun

    Hi,
    Is it possible to display entries in the front end (using any shortcodes by using form id)??