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.
Conditionally Hidden Target #
Shown for frontend image feeds and enabled by default. Leave Attach the generated image even when conditional logic hides the target field selected when the generated image is an output of the feed rather than a visitor-supplied upload. Gravity Forms normally omits conditionally hidden fields while creating an entry; the plugin attaches the verified generated image immediately after the entry is saved so later feeds and notifications receive it.
Clear this setting when hiding the File Upload field should also prevent the generated image from being attached. The visitor can still generate and preview the image, but it is not added to the entry if the target is hidden when the form is submitted. This setting does not change the field’s conditional logic or make it visible.
Gravity Forms must create an entry before the plugin can attach the image. If the hidden target is the only field with a value, Gravity Forms treats the submission as empty and displays At least one field must be filled out. Ensure the form submits a value from at least one other visible field; the generated image cannot satisfy this check because its hidden target is attached only after the entry is created.
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.
Content Filter #
OpenAI screens every image prompt against its own content policy, before and after generation. This setting chooses how strictly it does so.
- Standard (provider default) sends nothing extra and accepts OpenAI’s normal filtering.
- Less restrictive asks OpenAI to relax filtering to the extent it permits.
Less restrictive is not a bypass. OpenAI’s policies still apply, it can still decline a prompt, and you remain responsible for what your forms ask it to produce. The setting is sent only for models that support it; a custom model ID does not receive it.
Reach for it when legitimate prompts are being declined — descriptions of humanitarian, medical, or emergency work are the common case. Rewriting the prompt usually helps more than changing this setting. See the image generation troubleshooting page.
Content Refusal Message #
The opening sentence shown to the visitor when OpenAI declines a prompt under its content policy. Leave it empty to use the default.
Write it for the route forward this form actually offers. A form whose only option is to try again should not tell visitors to upload a file, and a form that accepts uploads should say so.
A sentence about the likely cause is added after it automatically. Visitors are only ever asked to change their own answers; when the cause came from this feed’s prompt they are told to contact the administrator instead, and the cause is recorded on the Overview tab for you.
Visitors can see this text. Do not put internal notes, provider details, or contact information that should stay private into it.
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.
