GravityPilot Documentation

Documentation

Table of Contents

GravityPilot 2.2.0 – Documentation

Welcome to GravityPilot 2.2.0, an advanced AI-driven form creation companion for Gravity Forms! GravityPilot integrates with OpenAI’s GPT-based models (including those with high-token capacities) to generate fully-configurable form layouts in JSON. This guide will walk you through:

1. Installation & Activation

Purchase & Download

  • Buy GravityPilot 2 from GravityPilot.io. Once purchased, the plugin ZIP file will be available in your account’s Downloads section.

Install Plugin

  • In your WordPress admin, go to Plugins → Add NewUpload Plugin.
  • Select the gravitypilot2.zip file, click Install Now, and then Activate.

Gravity Forms Requirement

  • You must have Gravity Forms installed and active. GravityPilot 2.2.0 will not function otherwise.

Note: GravityPilot 2 can technically run alongside GravityPilot 1.x, although you’ll likely only want to use the new version.

2. Accessing Your Download

After completing your purchase on GravityPilot.io:

  1. Log in to My Account.
  2. Navigate to Downloads.
  3. You’ll see GravityPilot 2 ready to be downloaded.

If a new version is released, you may see additional download links or notices in your account. Automatic updates via WordPress are not yet enabled, so re-download and reinstall if you need the latest features.

3. Plugin Overview & Interface

Once activated, GravityPilot 2 appears as a new menu item in your WordPress admin (left sidebar). Clicking it opens the main setup and form-generation interface. You’ll see two main tabs:

  1. Easy Mode – Quick generation and creation in a single step.
  2. Advanced Mode – Real-time streaming of the AI response and the ability to preview JSON before creating your form.

At the bottom of the Advanced Mode tab, you’ll also find a link to the GravityPilot GPT Companion, which opens a specialized ChatGPT environment in a separate window/tab.

Important Note on Advanced Logic: If you need multi-step forms, dynamic conditionals, or advanced calculations, these features are not yet implemented in GravityPilot’s automated JSON output. You can, however, generate a base form with GravityPilot and then manually configure advanced logic in Gravity Forms afterward.

4. Easy Mode

Overview

Easy Mode is the simplest way to generate a new Gravity Form:

  1. Enter OpenAI API Key

    • Paste your key into the designated field.
  2. Choose GPT Model

    • Defaults to gpt-4o-mini.
    • You can select other models (e.g., gpt-4o, o1-mini, o3-mini) if your GravityPilot license includes them (see Available GPT Models).
  3. Set Max Tokens

    • For complex forms, you might need a higher token limit (e.g., 15,000 or more).
  4. Describe Your Form

    • In the Form Description box, enter a concise or detailed prompt (e.g., “Create a website feedback form with name, email, message, rating scale, and so on.”).
  5. Save & Configure

    • Click Save & Configure to store your settings.
  6. Generate & Create Gravity Form

    • GravityPilot sends your prompt to OpenAI and automatically creates the form in Gravity Forms.
    • A success message appears with links to preview or edit your newly created form.

Viewing Suggestions & Usage Stats in Advanced Mode

Even if you generate the form in Easy Mode, you can switch over to Advanced Mode to view:

  • Suggested Fields (JSON) – A copy of the JSON that was generated for your form.
  • Usage Statistics (if supported by your chosen model).

5. Advanced Mode

Overview

Advanced Mode is ideal for users who want more control:

  1. Save & Configure Settings

    • Similar to Easy Mode, fill in your API key, model, max tokens, and form description.
    • Click Save & Configure to store.
  2. Generate Suggestions (Stream)

    • Click the Generate Suggestions (Stream) button.
    • A modal appears, showing partial chunks of the AI response in real time. This helps you gauge if the AI is generating what you need.
  3. Close & Review

    • After streaming completes, close the modal.
    • You’ll see the final JSON suggestion and usage stats under Suggested Fields and Usage Statistics.
  4. Create Gravity Form

    • If you’re satisfied, click Create Gravity Form.
    • GravityPilot will build a new Gravity Form using the generated JSON.

Clearing Old Suggestions

If you want to remove previously generated JSON:

  • Click Clear Suggestions to reset stored suggestions and usage data.

Post-Stream Quirk: Sometimes closing the post-stream modal sends you back to Easy Mode by default. If that happens, simply click “Advanced Mode” again to review or continue.

6. Using the Companion GPT

For very detailed or lengthy forms, we recommend using the GravityPilot GPT Companion:

  1. Open the Companion GPT

    • From the Advanced Mode screen, click the GravityPilot GPT Companion button.
    • This opens a specialized ChatGPT-like environment in a new tab.
  2. Refine Your Prompt

    • Instead of outputting JSON directly, the Companion GPT typically gives a human-readable outline of the fields, sections, file upload specs, etc.
    • Request as many details as you want: 40+ questions, in-depth multiple-choice, advanced placeholders, additional text fields, etc.
  3. Manually Copy the Final Outline

    • Important: Do not use the ChatGPT “copy button.” Instead, highlight the text from the first line of your final outline to the last line.
    • This preserves all formatting and ensures you have a complete prompt.
  4. Paste into GravityPilot

    • Paste your large, refined prompt into either Easy Mode or Advanced Mode under the Form Description.
    • Click Save & Configure and then proceed to generate your form.
    • GravityPilot will parse your pasted outline and turn it into JSON behind the scenes.

This workflow is incredibly powerful for large forms. The Companion GPT’s iterative approach lets you craft the perfect outline before GravityPilot finalizes it.

7. Available GPT Models & Pricing Notes

Depending on your license tier and what you’ve configured in your GravityPilot settings, you may see one or more of the following models available. Be aware of token costs—some advanced models can be expensive for large form generations.

Below is a simplified overview (context windows, max tokens, approximate cost ranges). Always refer to your OpenAI account or the official OpenAI documentation for the most up-to-date pricing.

GPT-4o & GPT-4o-mini

  • GPT-4o:
    • Context Window: Up to 128,000 tokens
    • Max Output Tokens: Typically 16,384
    • Higher intelligence, suitable for creative tasks; more expensive.
  • GPT-4o-mini:
    • Context Window: Up to 128,000 tokens
    • Max Output Tokens: Typically 16,384
    • A faster, more cost-effective variant that still performs extremely well for form generation.
    • Recommended for most use cases.

o1-mini & o3-mini

  • o1-mini:
    • Context Window: Up to 128,000 tokens
    • Max Output Tokens: ~65,536
    • Good reasoning, but relatively expensive compared to GPT-4o-mini.
  • o3-mini:
    • Context Window: Up to 200,000 tokens
    • Max Output Tokens: ~100,000
    • Similar cost & latency to o1-mini but provides higher intelligence and advanced reasoning.
  • Recommended only for power users who need extremely long or complex forms, or who want specialized “chain-of-thought” features.
  • Be mindful: These models can be costly for large prompts.

Future WordPress.org Version

A free version of GravityPilot is planned for the WordPress plugin repository. It will likely:

  • Only include Easy Mode.
  • Restrict model usage (e.g., only gpt-2o-mini, a smaller model).
  • Encourage upgrading to the premium plugin for advanced features.

8. Tips & Tricks

  1. Be Thorough in Your Prompt

    • The more context you provide about your form (audience, desired fields, number of questions), the better the output. If you want 40+ questions or an “expert-level intake form,” say so explicitly.
  2. Use the Companion GPT for Heavy Lifting

    • Craft highly detailed outlines of your form. Then copy-paste into GravityPilot for automated JSON generation.
  3. Manually Copy Outlines

    • Avoid the default ChatGPT copy button. Manually highlight the entire final outline.
  4. Advanced Logic Note

    • Conditional logic, calculations, and multi-step forms are not yet auto-generated by GravityPilot. You can add those features manually in Gravity Forms afterward.
  5. Review in Advanced Mode

    • Even if you generate in Easy Mode, check the Advanced tab to see usage stats and the raw JSON. It’s handy for debugging or making incremental changes.
  6. Bump Your Max Tokens

    • If you’re generating extremely large forms, increase max_tokens. Otherwise, the AI might truncate its responses.
  7. Monitor Costs

    • GPT-4o, o1-mini, and o3-mini can be significantly more expensive. For most users, gpt-4o-mini strikes a good balance between cost, speed, and output quality.

9. FAQs & Troubleshooting

I generated a form in Advanced Mode, but the stream timed out.

If you see errors like “cURL error 28” or “Gateway Timeout,” your server’s PHP settings may be too strict. Increase your max_execution_time and memory limits, or use a more robust hosting environment.

Refresh your Gravity Forms list. If it’s still missing, check the openai-gp2-debug.log in the GravityPilot plugin folder for error messages.

This can happen after streaming or closing the post-stream modal. Simply click the Advanced Mode tab again.

Yes. Some advanced models (o3-mini, o1-mini, GPT-4o) may be restricted to higher license tiers. Check your GravityPilot.io subscription details.

Yes, you pay OpenAI directly for API usage. Refer to OpenAI’s official pricing for the most current rates.

Not yet. GravityPilot 2.2.0 doesn’t produce multi-page or conditional logic steps in JSON. Please configure advanced features manually in Gravity Forms after creation.

Need More Help?

Thank you for choosing GravityPilot 2.2.0! We hope you enjoy creating powerful, AI-assisted forms with ease. Feel free to reach out with any feedback or feature requests.

Premium Pass

For professionals using GravityPilot on multiple websites with unlimited access to our template library.

$49

/ year

Premium Support

Limited Time Offer

Copy & Use the Coupon Code below at Checkout

"GPilot-@mbassador-xx1"

Free Lifetime Premium Pass

Open AI  Form Generator for Gravity Forms

Days
Hours
Minutes
Seconds

Remaining for this promotion

As an earlier promotion, you just earn…

100% off

Lifetime Premium Pass