Plugin how-tos · Guide
How to Style Gravity Forms (Step by Step)

Short answer
To style Gravity Forms, choose the Orbital form theme in the Gravity Forms block, then use the block's style settings to set colors, input size and border radius. For finer control, add custom CSS classes to the form or fields and write CSS rules in the Customizer, Site Editor or a child theme.
Key takeaways
- The Orbital form theme and block style settings handle most styling without any code.
- Field rows, widths and section breaks in the form editor control the layout.
- Custom CSS classes let you style one form or field without affecting others.
- Keep custom CSS in a child theme or Additional CSS, never in plugin files.
- Test contrast, focus outlines and error messages after every styling change.
What are the ways to style Gravity Forms?
You can style Gravity Forms with built-in form themes and block style settings, field layout options in the editor, custom CSS classes, and your own CSS in the theme or Customizer.
Most sites need only the first two. The Orbital theme and its block settings change colors, sizes and corners without code. Custom CSS is for details the settings do not cover, such as matching an unusual brand font or spacing.
Here is how the options compare:
| Method | Skill needed | Best for |
|---|---|---|
| Form theme (Orbital or legacy) | None | Clean, modern look with little effort |
| Block style settings | None | Brand colors, input size, border radius per form |
| Field layout and size settings | None | Columns, widths and field order |
| Custom CSS classes | Basic CSS | Styling one form or one field differently |
| Custom CSS rules | CSS | Full control over every element |
Work from the top of the table down. Each step adds control, but also adds code you must maintain after plugin updates.
How do you choose a form theme?
Pick a form theme in the Gravity Forms block settings for one form, or set a default theme for the whole site under Forms > Settings.
Newer versions of Gravity Forms include the Orbital theme, a modern design with clear inputs and buttons. The older Gravity Forms 2.5 theme is still available for sites that depend on its markup and existing custom CSS.
To change the theme for one form:
- Edit the page that holds the form in the block editor
- Click the Gravity Forms block
- In the block sidebar, find the theme option and choose Orbital or the legacy theme
- Update the page and preview it
The form themes and style settings documentation lists every option and which version added it. If you embed forms with a shortcode instead of the block, the theme comes from the site default unless you pass shortcode attributes.
If you already have a lot of custom CSS written for the older theme, test Orbital on a staging copy first. Some selectors behave differently.
How do you change colors, sizes and corners without code?
With the Orbital theme selected, the Gravity Forms block shows style settings for input size, border radius, colors for inputs, labels and buttons, which apply to that form only.
These settings are the fastest way to match your brand. Typical options include:
- Input size (small, medium or large)
- Border radius for inputs and buttons
- Input border, background and text colors
- Label and description colors
- Button background and text colors
Set the primary button color to your main brand color first. Then adjust input borders so they are visible against your page background, since faint borders are a common accessibility issue.
The Gravity Forms block settings guide describes what each control changes. Settings saved in one block do not affect the same form placed in another block elsewhere, so repeat them or use CSS for sitewide changes.
How do you control the form layout?
Use the form editor to place fields side by side in rows, set each field's size, and add section breaks or page breaks to group related questions.
In current versions you can drag a field next to another to create columns. Gravity Forms resizes them to share the row. You can also drag the edge of a field to change its width.
A few layout habits make forms easier to fill in:
- Put first and last name, or city and postcode, on one row
- Keep long text fields full width
- Use section breaks to split contact details from the message
- Use page breaks and a progress bar for long forms
On phones, Gravity Forms stacks columns into a single column automatically. Always check the form on a small screen after changing the layout.
Our guide on how to use Gravity Forms covers the form editor and field settings in more detail.
How do you add custom CSS classes to forms and fields?
Add a class in the form's Settings under the CSS class name option, or in a field's Appearance tab under Custom CSS Class, then target that class in your stylesheet.
Classes let you style one form or one field without touching the rest. For example, add contact-form-dark to a footer form, then write CSS rules that only apply inside that class.
To add a field class:
- Open the form in the editor
- Click the field and open the Appearance tab
- Type a class name in Custom CSS Class
- Save the form
Use clear names that describe the purpose, such as highlight-field or footer-form. Names that describe one color tend to become wrong when the design changes.
Where should you put custom CSS?
Put custom CSS in a child theme stylesheet, the Additional CSS panel in the Customizer, or the Styles panel of the Site Editor, never in the Gravity Forms plugin files.
Plugin files are replaced on every update, so edits there are lost. The safest places are:
- Additional CSS under Appearance > Customize on classic themes
- Additional CSS in the Site Editor's Styles panel on block themes
- A child theme's style.css file for larger amounts of CSS
If you are not sure what a child theme is, read what a child theme is first. The WordPress child theme handbook explains how to create one.
If your rules do not appear, see our guide on how to fix CSS changes not showing. Caching is usually the reason.
Which CSS selectors does Gravity Forms use?
Every form sits inside a wrapper with the class gform_wrapper, and common selectors include gfield for each field, gfield_label for labels and gform_button for the submit button.
Here is a simple example that styles the submit button and labels for one form with a custom class:
.footer-form .gform_button {
background: #1d4ed8;
color: #fff;
border-radius: 6px;
padding: 12px 24px;
}
.footer-form .gfield_label {
font-weight: 600;
}
Each form also gets an ID-based wrapper, such as gform_wrapper_3 for form 3. Use it when you want to target one form without adding a class.
The Orbital theme uses CSS custom properties that start with --gf-. Changing those properties is often cleaner than overriding many separate rules. The Gravity Forms Theme Framework docs list the available properties.
Use your browser's inspect tool to find the exact class on any element. The MDN CSS reference is useful if you need to check a property.
Should you turn off the default Gravity Forms CSS?
Only turn off the default CSS if you plan to style every part of the form yourself, because forms without it lose spacing, layout and validation styling.
Gravity Forms has a setting under Forms > Settings to stop outputting its default CSS. Some developers use it to load a fully custom design and avoid extra stylesheet weight.
For most site owners, keeping the default CSS and adding small overrides is easier. You keep responsive columns, error message styling and accessible focus states without writing them yourself.
If you do turn it off, test every field type you use, including dropdowns, checkboxes, file uploads and validation errors.
How do you make styled forms accessible?
Keep strong color contrast, visible labels, clear focus outlines and readable error messages, because styling changes can easily hide information people rely on.
Common mistakes include light gray placeholder text used as the only label, buttons with low-contrast text, and removing the outline that shows which field has focus.
Check your colors with a contrast tool, and tab through the form with a keyboard. Every field and the submit button should show where focus is.
The WordPress accessibility handbook has guidance on forms, labels and focus styles that applies to any form plugin.
How do you test your styled form?
Preview the form on desktop and mobile, submit it with valid and invalid data, and check that confirmation and error messages still look correct.
Validation states are easy to forget. Submit the form empty to see how required-field errors look with your new colors. Then submit a real entry and check the confirmation message.
Clear any page cache after styling changes so you see the live version. If the form also sends email, confirm it still arrives; our guide to fixing Gravity Forms notifications helps if it does not.
Frequently asked questions
Can I style Gravity Forms without writing CSS?
Yes. Choose the Orbital theme in the Gravity Forms block and use its style settings to change input size, border radius, and colors for inputs, labels and buttons. Combined with field rows and widths in the form editor, this covers what most sites need without any code.
Why do my Gravity Forms style changes not show?
The most common reasons are page or CSS caching, a selector that is less specific than the plugin's own rule, or styling a form embedded by shortcode that uses the site default theme. Clear all caches, inspect the element in your browser, and make your selector more specific if needed.
What is the Orbital theme in Gravity Forms?
Orbital is the modern form theme included in newer Gravity Forms versions. It gives forms a clean design and adds block style settings for colors, sizes and corners. The older theme is still available for sites with custom CSS written for its markup.
Is it safe to edit the Gravity Forms CSS files directly?
No. Plugin files are replaced whenever Gravity Forms updates, so any edits there are lost. Add your CSS to the Additional CSS panel, the Site Editor styles, or a child theme stylesheet so it survives updates.
How do I put two fields side by side in Gravity Forms?
In the form editor, drag one field next to another until a drop zone appears beside it. Gravity Forms places them on the same row and shares the width. You can drag the field edge to adjust widths, and the columns stack on small screens.
Sources
- Form Themes and Style Settings Gravity Forms
- Gravity Forms Block Settings Gravity Forms
- Gravity Forms Theme Framework Gravity Forms
- Child Themes WordPress Developer Resources
- CSS reference MDN Web Docs
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


