☰

Free Gravity Forms add-on

CSS Selector

Quickly select custom and add-on CSS classes.

CSS Selector is a free Gravity Forms add-on that adds a class picker to the form editor. Select your own custom classes, Gravity PDF shortcuts and the Gravity Wiz Copy Cat shortcut without remembering class names.

In Forms > Settings > CSS Selector, the site's own form classes are listed in a class library and one more is added. In the form editor, the selector next to Custom CSS Class shows them by group: the notice gets an info box class with a double-click, the ticket choices a pill-button class, and the sessions reuse that class from 'Used on other fields'. On the front end the theme styles them.

For Gravity Forms users who want quick access to custom and add-on CSS classes in the form editor.

Nothing to remember

Keep custom and add-on class shortcuts in one small pop-up. Select the class you need instead of looking up its name.

No typos

A mistyped class name does nothing. Clicking a button always adds the exact class.

Your house style in the same place

Add your own classes to the pop-up, so everyone who builds forms uses the same ones.

Use cases

  • Keep internal fields out of the PDF you send with Gravity PDF.
  • Start a new PDF page at a specific field.
  • Add a Copy Cat shortcut and adjust its field IDs for your form.
  • Give your team a fixed set of house-style classes in the pop-up.
  • Maintain existing forms without automatically removing their saved classes.

Features

  • One click from the field settings

    A button under the Custom CSS Class setting opens the pop-up. Click a class to add it to the field. Double-click to add it and close the pop-up.

  • Your own classes

    Manage class names, labels, descriptions and groups under Forms → Settings → CSS Selector without writing PHP. The gwp_css_selector_add_custom_css filter remains available for developer-defined buttons. Your stylesheet supplies the styles; CSS Selector adds the class names.

  • Gravity PDF shortcuts

    Leave a field out of the PDF with exclude or start a new PDF page with pagebreak. These shortcuts require Gravity PDF.

  • Copy Cat shortcut

    Add copy-1-to-2 to copy a value from Field ID 1 to Field ID 2 with Gravity Wiz Copy Cat. Adjust the IDs for your form; Copy Cat must be installed.

  • Saved classes stay intact

    Existing field classes are not removed or rewritten automatically. Adding a shortcut keeps the field’s other class names. Used on other fields offers classes already saved on other fields in the same form, with usage counts and a Legacy label where applicable.

  • Legacy Ready Classes on older Gravity Forms

    Applicable Ready Classes remain in the picker on Gravity Forms versions earlier than 3.0. On Gravity Forms 3.0 and later, built-in Ready Classes are hidden. Use native Choice Layout settings for radio button and checkbox layouts and the native editor for field columns.

Ready to use CSS Selector? Free download.

Download for free

Why GravityWP

Gravity Forms specialists since 2014. The people who build the add-ons also answer your questions.

5.0/5from 30 reviews on WordPress.org and GoogleRead more

Built the Gravity Forms way

Our add-ons use the official Gravity Forms add-on framework, so settings, feeds and entries work the way you already know.

Compatibility guaranteed

Works with current Gravity Forms versions and certified add-ons like Gravity Flow, GravityView and Gravity Perks. If something conflicts, we fix it.

Support from the developers

Your question goes straight to the people who wrote the code. Good feature requests often make it into the next release.

What customers say

I tried the other css selector plugin but that looks like it has been abandoned. Found this and very impressed. Worked well and like all the options. […]
bruno05, review on WordPress.org
Does the job exactly how you want.. wish I could drop 10 points here
swiftblack, review on WordPress.org
Handy little plugin as I always forget the selectors. Many thanks
abiruth, review on WordPress.org

More about GravityWP

Free download

CSS Selector is free.

Download for free

Questions before you start? Ask us

Frequently Asked Questions

Is CSS Selector free?

Yes. CSS Selector remains free and available. Development focuses on compatibility and maintenance, not expanding the legacy Ready Class catalogue.

Do I need to know CSS or write code?

No. You can manage your class shortcuts under Forms → Settings → CSS Selector and click them in the picker without writing PHP. Your stylesheet must provide the matching styles. Developers can also add buttons with a filter.

Can I add more than one class to a field?

Yes. Click several shortcuts to combine custom and add-on classes. Existing saved classes remain in the field.

Can I add my own CSS classes to the pop-up?

Yes. Use the class library under Forms → Settings → CSS Selector to add names, labels, descriptions and groups without PHP. The gwp_css_selector_add_custom_css filter is still available for developer-defined buttons.

Does it slow down my forms?

No. It only runs in the form editor and adds class names to the field setting. It loads nothing on the front end of your site.

Which classes do I see?

Custom class buttons, Gravity PDF and Copy Cat shortcuts remain available. Built-in Ready Classes are legacy functionality and are hidden on Gravity Forms 3.0 and later; use native Choice Layout settings instead of old choice layout shortcuts. On earlier versions, the picker shows applicable legacy classes.

Examples

ClassUse it onResult
excludeAny field (Gravity PDF)The field is left out of the PDF
pagebreakAny field (Gravity PDF)A new PDF page starts with this field at the top

Adding your own classes is described in the documentation.

Requirements

  • Gravity Forms 1.5 or later; built-in Ready Classes are shown only on versions earlier than 3.0
  • WordPress
  • Optional: Gravity PDF, for the exclude and pagebreak classes
  • Optional: Gravity Wiz Copy Cat, for the copy-1-to-2 class

Current version 1.1.1, updated 8 October 2026. View the changelog

Documentation and tutorials

All CSS Selector documentation

Changelog of CSS Selector

Maintenance and compatibility update for Gravity Forms.

  • Hide built-in legacy Ready Classes on Gravity Forms 3.0 and later; preserve saved field classes.
  • Keep Gravity PDF, Copy Cat and custom class shortcuts available.
  • Add a no-code class library under Forms > Settings > CSS Selector.
  • Reuse classes from other fields, with legacy class labels.
  • Restore editor hook registration with modern GFForms and safely encode picker markup.
  • Update plugin positioning and native Choice Layout guidance.
  • Update Tested up to to WordPress 7.1.

Checks: PHP and JavaScript syntax, WordPress/Gravity Forms smoke tests, simulated GF version gates, class-library sanitization, and saved-class preservation.= 1.1 =

  • Added pot files for translations
  • Updated Dutch translation.

1.0.4

  • Minor enhancements.

1.0.3

  • Minor enhancements.

1.0.2

  • Added Gravity Forms version check, hide deprecated CSS Ready Classes in 2.5 and higher
  • Added title tags with more detailed description of the function of every CSS class
  • Added new vertical choices columns (gf_list_2col_vertical, gf_list_3col_vertical, gf_list_4col_vertical, gf_list_5col_vertical), only visible in GF 2.5 and higher
  • Added new HTML Field Classes (gf_alert_green, gf_alert_red, gf_alert_yellow, gf_alert_gray, gf_alert_blue), only visible in GF 2.5 and higher
  • Added gf_inline CSS Ready Class
  • Updated url to GravityWP documentation to add custom CSS buttons to the CSS selector (https://gravitywp.com/doc/add-custom-css-buttons/)
  • Security enhancements

1.0.1

  • Updated url to official Gravity Forms CSS Ready Classes documentation (https://docs.gravityforms.com/css-ready-classes/)

1.0

  • Add gwp_css_selector_add_custom_css filter to add custom css
  • Updated translation files

0.2.2

  • Adjusted the Gravity PDF pagebreak CSS
  • Added gf_invisible CSS class
  • Combined list columns and list heights to Radio Buttons & Checkboxes
  • Changed links to documentation

0.2.1

  • Added pagebreak support for Gravity PDF
  • Updated translation file
  • Updated Dutch translation

0.2

  • Added CSS classes for Gravity PDF (exclude) and Gravity Wiz (Copy Cat)
  • Updated layout (documentation available on click)

0.1

  • Initial Release
  • Added localisation

Start using CSS Selector today

Quickly select custom and add-on CSS classes.

Download for free
Proudly powered by WordPress