Image feeds are created under Form Settings -> AI Image and use OpenAI.
Model lifecycle #
GPT Image 2 is the recommended default. GPT Image 1.5 and GPT Image 1 Mini are deprecated and are not offered for new selections. A feed that already uses one keeps showing it with a warning until OpenAI’s December 1, 2026 retirement date. On that date the feed stops generating images until an administrator explicitly selects and saves a supported model. The plugin does not automatically move the feed to GPT Image 2 because model behavior, capabilities, and pricing can differ.
Prompt #
Describe the image to generate. The merge-tag button inserts current form values. Good prompts state the subject, setting, composition, visual style, colors, orientation, intended use, text that must appear, and important exclusions.
Example: Create a clean square event illustration featuring {Event subject:3}. Use {Brand colors:4}, leave clear space at the top for a headline, and do not include logos or written text.
All merged values are sent to OpenAI. Provider safety policies can reject a prompt even when its format is valid.
Target File Upload Field #
Choose a File Upload field from the current form. The generated image is saved there so Gravity Forms and connected add-ons can treat it as an entry file.
For an after-submission feed, the target File Upload field must be optional. Gravity Forms checks required fields before the feed can generate the missing file. Frontend generation also needs the target field so the verified temporary image can be associated with the submitted entry.
Size #
- Automatic sends
auto; OpenAI chooses the size according to the selected model and service behavior. - 1024 x 1024 creates a square request and is the default for a new feed.
- 1536 x 1024 creates a landscape request.
- 1024 x 1536 creates a portrait request.
- Custom GPT Image 2 size reveals Custom Size and requires GPT Image 2.
Automatic does not mean the plugin inspects the form or preview area. The decision is delegated to OpenAI.
Custom Size #
Enter WIDTHxHEIGHT, such as 1280x720. Both edges must be divisible by 16. The aspect ratio cannot exceed 3:1, no edge can exceed 3,840 pixels, and the total must be between 655,360 and 8,294,400 pixels. This setting is accepted only for the catalog’s GPT Image 2 model.
Larger images can take longer and may cost more. Confirm current provider pricing before using large dimensions on public forms.
Quality #
- Automatic sends
auto; OpenAI chooses the quality. - Low, Medium, and High request an explicit quality level.
Higher quality can increase generation time and cost. Automatic does not inspect the prompt or site design locally; it delegates the choice to the provider.
Output Format #
Choose PNG, JPEG, or WebP. PNG is the default and is useful for lossless graphics. JPEG is often smaller for photographic images. WebP can offer smaller modern web images but may be less suitable for external systems that expect PNG or JPEG.
Who Can Use The Frontend Button? #
Shown only for a frontend trigger. Public access allows anyone who can view the form to request an image, subject to signed tokens and rate limits. Administrator-only access requires a logged-in user with Gravity Forms full access. See the trigger/access reference.
