Gravity Forms Collapsible Sections - WordPress Plugin
Gravity Forms Collapsible Sections is a plugin for WordPress that enhances the functionality of Gravity Forms by allowing users to group form fields into accordion-style sections. With this plugin, users can easily create collapsible sections within their forms, providing a more organized and intuitive user experience.

Plugin Features
Gravity Forms Collapsible Sections offers a simple and efficient way to manage large forms with multiple fields, as it allows users to collapse or expand sections as needed. By grouping related fields together, users can navigate through the form more easily, focusing on the specific sections that are relevant to them.
One of the key features of this plugin is its flexibility. Users have the ability to customize the appearance of the collapsible sections, such as choosing the colors, icons, and styling options that align with their websites design. This ensures that the form seamlessly integrates with the overall look and feel of the website.
In addition to the aesthetic customization options, this plugin also provides users with a range of functionality options. For example, users can configure the sections to automatically expand or collapse upon page load, enhancing the user experience. Users can also enable or disable the ability to have multiple sections open simultaneously, depending on their specific form requirements.
Another valuable feature of this plugin is the ability to add conditional logic to the collapsible sections. Users can set up rules that determine when a section should be visible or hidden, depending on user inputs or other factors. This allows for more dynamic and interactive forms, where irrelevant sections are hidden to streamline the user experience.
The Gravity Forms Collapsible Sections plugin integrates seamlessly with the popular Gravity Forms plugin, providing additional functionality without sacrificing the familiar interface and ease of use. Users can simply install and activate the plugin, and the collapsible sections feature will be available within the form builder.
Overall, the Gravity Forms Collapsible Sections plugin is a valuable tool for users who want to improve the organization and user experience of their Gravity Forms. With its customizable appearance, flexible functionality options, and seamless integration, this plugin provides a powerful solution for creating advanced and user-friendly forms.
Specifications:
| Release date: | 11-10-2022 | |
| Last updated: | 04-10-2026 | |
| Type: | Paid | |
| License: | GPL | |
| Subject: | Structure & Navigation for Gravity Forms | |
| Compatibility: | W5.x W6.x | |
| Includes: | Plugin | |
| Language packs: |
|
|
| Developer: | JetSloth | |
| Rating: | ||
Share with your friends!
Guide to Configuring and Using Gravity Forms Collapsible Sections
Gravity Forms Collapsible Sections is not just there to "dress up" a form. Its real purpose is to make a long input flow easier to manage. In this guide, we will look at how to turn standard Gravity Forms fields into clear collapsible sections, where to enable accordion behavior, which settings to review after installation, and how to confirm that visitors see the right result on the page.
This article is for a WordPress site owner, webmaster, or developer who already works with Gravity Forms and wants to make a long inquiry form, questionnaire, service request form, registration form, or WooCommerce form less tiring to complete. We will not repeat the short product description. What matters here is understanding how sections work, how they affect required-field validation, how they interact with conditional logic, how to style them, and how to troubleshoot common issues.
We will also pay special attention to safe testing: first a test form and a draft page, then the behavior of open sections, then validation, emails, and confirmation, and only after that the live workflow. That order lowers the risk of ending up with a nice-looking form that hides an error, the submit button, or an important field.
When a Long Form Needs an Accordion Instead of a Multi-Page Wizard
Collapsible sections are useful when a form cannot honestly be shortened, but it can be organized better. If a user needs to leave contact details, choose a service, describe the request, attach a file, and confirm terms, a standard vertical form quickly turns into a wall of fields. People see too much at once, lose their entry point, and may assume the form will take longer to complete than it actually will.
Gravity Forms Collapsible Sections uses the familiar Section Break field in Gravity Forms as the boundary for a group. In standard Gravity Forms, that field acts as a visual divider and does not collect data. This plugin adds behavior to it: a section can start a group of fields, close the previous group, or remain a normal divider. That is why the main design question is: which fields should feel like one logical step?
An accordion works better than a multi-page flow when the user should be able to see the overall structure of the form and quickly return to an earlier block without moving between pages. For example, in a consultation request, sections like "Contact Details," "Project Overview," and "Budget and Timeline" work well on one page. The user understands the scope of the form without seeing every field at once. A multi-page wizard with Page Break makes more sense when each step must be validated separately, when explicit "next - back" navigation is needed, or when the form is simply too complex for a single page.
There is a tradeoff, though. A collapsible interface will not rescue a poorly designed form. If fields duplicate each other, there are too many required questions, or the instructions are vague, an accordion only hides the problem. Before you configure anything, remove unnecessary fields, group questions by meaning, and decide which sections actually help the user.
Practical rule of thumb: if the user needs to complete 3 to 5 meaningful groups on one page, an accordion is usually a good fit. If there are more steps, each step has a lot of required validation, or you need separate progress tracking, compare Collapsible Sections with a multi-page Gravity Forms setup.
For both SEO and usability, it matters that the plugin does not create separate pages and does not change the form's actual purpose. It changes the interaction inside the embedded form itself. Search engines and analytics still see the same page, but user behavior may change: less scrolling, less visual noise, and clearer stopping points. That does not guarantee higher conversions, but it gives the webmaster a clean way to test long-form usability.
What to Check Before Installing It on a WordPress Site
Do not start with design. First, confirm basic compatibility: Gravity Forms should already be installed and active on the site, and the form you want to improve should submit correctly without Collapsible Sections. If the original form already fails required-field validation, does not send emails, or conflicts with the theme, a new interface will only make troubleshooting harder.
The developer lists a minimum Gravity Forms dependency for the current Collapsible Sections branch. That matters not just as a version number, but as a warning sign: if the site has not been updated in a long time, review Gravity Forms itself, the theme, PHP, and any critical integrations first. On older projects, pay extra attention to legacy markup, because the plugin changelog includes several fixes related to Gravity Forms markup, the Gravity Forms theme, and compatibility after major changes in the core forms system.
Reviewing the Existing Form
Open the form in the Gravity Forms editor and evaluate it as a workflow, not just a list of fields. A few minutes of preparation can save hours of debugging after the plugin is turned on.
- Group fields by task: contacts, request details, order parameters, files, and consents.
- Review required fields and error messages so users understand exactly what needs to be fixed.
- Make sure conditional logic already works before installing Collapsible Sections: hidden fields should appear and disappear at the right time.
- Submit a test entry and check the record in
Entries, notifications, and confirmation. - Save a copy or export of the form if you plan to modify a complex live form.
What Can Get in the Way of a Clean Launch
Most problems are caused not by the accordion itself, but by the layers around it: aggressive JavaScript optimization, page caching on the form page, custom theme CSS, multiple instances of the same form on one page, conditional logic, and third-party fields. The JetSloth changelog includes fixes for WooCommerce Gravity Forms Product Add-Ons, Multiple Form Instances, GravityView, GravityFlow, the Signature field, conditional logic, and the newer Gravity Forms themes. That does not mean those combinations will definitely conflict, but they do need to be tested on your site.
If the form is embedded through a page builder, modal, or tabbed layout, also check the initialization timing. The accordion needs time to wrap fields into body containers after the form loads. If the container is hidden when the page first loads, some JavaScript elements may calculate the wrong height or fail to update state correctly. In cases like that, enable the plugin on a simple test page first, then move it into the more complex layout.
Minimum Safe Test Plan
- Create a copy of the long form or a separate test form with the same field types.
- Place it on a draft WordPress page using the standard Gravity Forms block or
Embed. - Add sections and enable Collapsible Sections behavior only on the copy.
- Test opening, closing, submission, validation errors, emails, and behavior after a page reload.
- Only after that, recreate the same structure on the live form.
That order is especially important for lead forms, where losing submissions costs more than any visual improvement is worth. Reliability first, appearance second.
Installation and the First Check in the Gravity Forms Editor
After the plugin is installed in WordPress, the basic workflow stays familiar: you edit the form in Gravity Forms, add or select a Section Break field, and configure how it behaves. In the JetSloth documentation, the key step is described simply: add a section and enable it to be used as a collapsible section. In practice, it is not enough to check the box. You also need to understand where that section starts and where it ends.
Do not start with a live form that is already receiving submissions. Make a copy so you can test the structure without pressure. In the WordPress admin area, go to Forms, open the target form, add a Section field from the standard Gravity Forms fields, and configure it in the field settings panel. The exact tab names may vary depending on your Gravity Forms version and interface, but the logic stays the same: field properties are managed in the form editor, while Collapsible Sections behavior is added to section fields and form-level settings.
First Test After Activation
A minimal test form should include three sections and a few fields between them. That is enough to show whether the plugin is grouping fields correctly and whether it leaves form submission intact.
- Add a section called "Contact Details" and enable the behavior that starts a collapsible group.
- Under that section, add
Name,Email, andPhoneif they are needed for the workflow. - Add a section called "Project Description" and enable it as the next collapsible block.
- Add a
Paragraph Textfield and, if needed, a file upload field. - Add a section called "Confirmation" and place a consent field, comment, or final clarification under it.
- Save the form, open the page with the form as a regular visitor, and make sure the sections expand.
If the fields still appear as one standard list, check two things: is the plugin active in WordPress, and is the behavior enabled on the actual sections rather than on regular fields? If one section is "capturing" too many fields, review the boundaries: the next section should start a new block or explicitly close the previous one if you want the form to continue with normal fields.
Why the Front End Matters More Than the Editor Alone
The form editor shows structure, but the user interacts with the form on the page itself. That is where the theme styles, optimization scripts, cache, editor blocks, popups, and third-party fields come into play. After every major change, open the page as a visitor: in a regular window, in a private window, and, if the form matters, at a mobile width. Checking the editor does not replace testing the actual page behavior.
Quick takeaway: the first goal after installation is not to "make it look nice," but to confirm that sections group the right fields, expand without delay, preserve required validation, and do not interfere with submission.
How a Section Is Built: Start, End, and Fields Outside the Accordion
The most important mechanic in Gravity Forms Collapsible Sections is boundary control. A standard Gravity Forms divider does not know on its own where a logical block should end. The plugin adds modes that let you make a section the start of a group, close the previous group, or leave part of the form outside the accordion entirely. Most mistakes happen at these boundaries: a field ends up in the wrong section, the submit button gets hidden in the wrong place, or a user opens one block and sees unexpected content.
Think of the form as a sequence: section heading, fields inside it, next section heading, new fields. If you want the fields after the accordion to return to a standard vertical layout, use the mode that closes the previous section. The JetSloth documentation explicitly notes that you can start and close a collapsible section and then continue adding fields as usual.
The "Everything Inside Sections" Scenario
This is the simplest and most reliable option. Each logical group starts with a section, and the next section automatically becomes a new block. This works well for questionnaires, registrations, quote requests, service matching forms, and long contact forms. The user sees a list of sections, opens the one they need, and never runs into stray fields between sections.
In that setup, section names matter. The heading should explain not just the topic, but the action: "Contact Details," "Project Parameters," "Files and Comments," "Request Confirmation." Avoid internal labels like "Section 1" or "Block A" on a live site. They do not help the user and they make the form harder to maintain.
The "Accordion for Only Part of the Form" Scenario
Sometimes you only want to collapse one complex block and leave the beginning and end of the form open. For example, a short email field can stay visible while additional interest options are tucked into a section. Another example is a donation form: the amount and contact details stay visible, while an "Additional Preferences" block expands only if needed.
In this scenario, it is especially important to close the previous section before normal fields resume. Otherwise, the plugin may treat the next fields as part of the expandable block. If a normal button, text, or field should appear after the section, make sure the last section mode closes the previous group and does not create an unnecessary empty heading.
Description Inside the Heading or Inside the Body
The CSS documentation shows two markup patterns: a section description can be tied to the heading, or it can be placed inside the collapsible body. From the user's perspective, those are very different choices. A heading-level description works well for a short prompt like "Tell us how to reach you." A body-level description is better for longer guidance that should not weigh down the list of collapsed sections.
If the form has many sections, do not overload closed headings with long descriptions. It is better to keep the section title short and add more detail inside the section after it is opened. That makes the form easier to scan and puts the extra context exactly where it is needed.
Checking Boundaries Without Special Tools
After saving the form, review it the way a user would. Open the first section, fill in the fields, then expand the second. If single-open mode is enabled, the first section should close. If multiple open blocks are allowed, it can stay expanded. Then check the field that is supposed to sit outside the accordion: it should be visible without expanding the last block. If it ends up hidden, the problem is almost always the section boundary.
Core principle: every field should have a clear home - either inside a specific section or outside the accordion. If you cannot explain where it belongs at a glance, it will be even harder for the user.
Form Settings That Control Accordion Behavior
Once your sections are grouped correctly, move on to behavior settings. Collapsible Sections includes both global settings and form-specific settings. The global level is useful for shared CSS rules and base styling, while the form level is where you shape the behavior of a specific workflow. The JetSloth documentation describes a settings screen where you can control open sections, accordion behavior, animation, and custom CSS.
For most sites, it is better to start with the form-level settings. That way, you are not changing every form on the site, and you can test one workflow in isolation. Global CSS only makes sense once you already have an approved section style and want to apply it consistently across all forms.
Which Sections Should Be Open on Load
The open-sections setting determines the first impression. If every block is closed, the form looks compact, but the user has to make the first click. If the first section is open, it is easier to get started. If all sections are open, Collapsible Sections works more like visual grouping than hiding, which can be useful on sites where required information should never be tucked away.
For a standard request form, a good starting point is to open the first block and keep the rest closed. That gives the user a clear entry point without exposing every field at once. If the form is more like a reference questionnaire where the user may begin anywhere, you can keep all sections closed, but the headings need to be extremely clear.
One Open Block or Several
The mode that keeps only one section open helps keep the form compact. It works well for long questionnaires where each block represents a step. But it can become frustrating if the user needs to compare data across sections or copy information from one block to another. Multiple open sections are more convenient for forms that people fill out gradually and in no strict order.
| Form Scenario | Best Behavior | What to Check |
|---|---|---|
| Step-by-step service request | One open block | Jumping to the section with the error after a failed submission. |
| Questionnaire with independent sections | Multiple open blocks | The user can keep related fields visible side by side. |
| Form with required legal sections | First block open, important sections not buried too deeply | Consents and warnings are visible before submission. |
| Form inside a WooCommerce product | Depends on length and pricing options | Price recalculation, required fields, and add-to-cart still work after expansion. |
Do not choose a mode based on personal taste. Test how the user fixes an error. If the form reports that a required field is missing after submission, the section containing that error should be visible or easy to reopen. The JetSloth changelog includes fixes related to opening sections after validation errors and proper aria-expanded attributes, so error handling is a required part of setup.
Scrolling, Offset, and Animation
The plugin supports scrolling settings and behavior after a section is opened or closed. These are useful when the form sits below the fold or when the site has a sticky header. If a click causes the page to scroll in a way that hides the section heading under the top bar, adjust the offset or disable overly aggressive scrolling.
Animation can make the interface feel smoother, but it should never get in the way. If the form is heavy, contains a lot of conditional logic, or is embedded in a complex layout, a long animation may make the interface feel sluggish. Start with a moderate setting and test it on the real page. If users need to open several blocks quickly, fewer effects and more predictability usually work better.
Where to Place the Submit Button
The footer placement setting affects where the submit button appears: after the last section or inside it. If the button is hidden inside the last block, the form feels more like a step-by-step process and users are expected to move through it to the end. If the button sits after all sections, it stays more obvious, but it can feel disconnected from the final step.
For a request form, it is often more intuitive to place the confirmation content and the button together in the final section. For a questionnaire with independent sections, it is usually better to place the button after all blocks so it does not look tied to only one section. After changing this setting, make sure the button does not disappear when a section closes and is not duplicated by the theme.
Section Design: Themes, Images, Descriptions, and Safe CSS
The visual side of Collapsible Sections should make the form easier to read. On the JetSloth product page, the developer lists ready-made styles such as Simple, Accordion, Bordered, and Retro, and also shows that you can add images to sections. In the documentation for version 1.2, new display themes and section images are highlighted separately. Those features matter because an accordion form can either look clean and useful or become unnecessarily noisy.
Start with a built-in style that fits your site theme. Then adjust spacing, colors, and section descriptions. Do not try to create a completely custom design right away with a large CSS layer. If the plugin's base theme already reads well and does not conflict with the site, small adjustments are usually enough: the color of an open section, spacing, border radius, and the error state.
When to Add Images to Sections
Images in section headings are useful when they explain the meaning of a block faster than text alone. For example, in a service booking form, a calendar icon next to the "Date and Time" section helps people scan the form. In a client questionnaire, an image can mark sections like "About the Project," "Contact Details," or "Files." But images should not turn the form into a gallery. If the user is on a mobile device, large graphics in every section may cause more friction than clarity.
For a typical site, use small, consistent images or icons. Check how they look in both collapsed and expanded states, and make sure they are not stretched or overlapping the heading. The plugin changelog mentions extra settings for the image option, including background color, image size, and corner radius. That suggests visual parameters are best adjusted through plugin settings, when available in your version, rather than through rough CSS overrides.
Section Descriptions: Short Guidance Works Better Than Long Text
A description should answer the user's question: "What do you need from me in this section?" A good description is short: "Tell us how to reach you," "Describe the task and your preferred timeline," or "Attach files if they will help us review the project." A bad description repeats the heading or turns into a multi-line legal notice.
If longer instructions are necessary, place them inside the expanded block, not in the heading of a closed section. That keeps the collapsed list light while still showing details after the click. In the description settings and markup examples shown in the JetSloth documentation, that distinction matters for later CSS work.
A Safe CSS Tweak for the Open State
The JetSloth documentation shows the classes collapsible-sections-field, collapsible-sections-open, and collapsible-sections-collapsible-body. Based on those classes, you can make a small tweak that does not modify the plugin core and is easy to roll back. Add CSS like this in the Collapsible Sections form area, in the plugin's global CSS, or in a child theme stylesheet if you control the theme.
/* Clean highlight for an open section without editing plugin files */
.gform_wrapper .collapsible-sections-field.collapsible-sections-open {
border-color: #0275ff;
background: #f2f7ff;
}
.gform_wrapper .collapsible-sections-field.collapsible-sections-open .gsection_title {
color: #123a66;
}
.gform_wrapper .collapsible-sections-collapsible-body {
border-radius: 0 0 8px 8px;
}
After adding the CSS, open the form on the front end and check three states: a closed section, an open section, and a section showing an error after a failed submission. If your site theme already applies strong styles to .gsection, your rules may conflict. In that case, do not keep increasing selector strength forever. Remove unnecessary theme CSS instead, or limit the adjustment to one specific form through the form's CSS class.
What Not to Change with CSS
Do not hide error messages, required markers, field hints, or the submit button just to make the design look cleaner. Do not rewrite section-opening logic with custom JavaScript if the plugin already provides the behavior setting you need. Do not edit the plugin files directly: an update will overwrite your changes, and future debugging will become harder. If you need an unusual workflow, check the JetSloth documentation, changelog, and support channels first.
A safe customization should be small, reversible, and easy to verify. If you cannot clearly explain how to roll it back, it is better to keep the default style.
Practical Example: A Service Request Form with Three Collapsible Blocks
Let us walk through a real scenario: a request form for development work or a consultation. The goal is to collect enough information for the first response without showing the user a long list of fields all at once. The form will have three sections: contact details, the request itself, and project details. At the end, the user submits the form and sees the standard Gravity Forms confirmation.
Goal and Preparation
We want a form where the first block is open by default, the second and third are closed, and any validation error makes it obvious which section needs attention. Before you begin, both Gravity Forms and Gravity Forms Collapsible Sections should already be installed, and the site should have a draft page for testing.
Planned Form Structure
- Section "Your Contact Details": name, email, phone number, or messenger handle.
- Section "What Needs to Be Done": task type, short description, site URL, or project link.
- Section "Timeline and Materials": preferred deadline, budget range, file upload, or comment.
- Confirmation and submit button: standard Gravity Forms submission with no hidden purchase flow or third-party step.
Setup Steps
- Create a new form in
Formsor duplicate an existing request form. - Add the first
Sectionfield and name it "Your Contact Details." Enable the mode where the section starts a collapsible group. - Add name, email, and phone fields. Make email required if it is needed for follow-up.
- Add the second section, "What Needs to Be Done," and use it as the start of the next collapsible group as well.
- Add a task-type selector and a description field. If the task choice affects additional fields, configure that conditional logic before the final accordion test.
- Add the third section, "Timeline and Materials," plus deadline, budget, and file upload fields if needed.
- Open the form's Collapsible Sections settings and set the initial state: first section open, the rest closed.
- Decide whether only one block should stay open. For this form, that usually works well because the user moves through the request as a sequence.
- Check the submit button placement: it should be visible at the end of the flow and not accidentally hidden inside an empty block.
- Save the form and embed it on a draft page using
Embed, the Gravity Forms block, or a shortcode.
Expected Result
On the page, the user sees a compact form. The first block is expanded and invites them to start with contact details. The second and third blocks appear as clear headings. When each block is opened, its fields appear directly under the correct heading. If single-open mode is enabled, the previous block closes when the next one opens. If the user skips the required email field and submits the form, the error should lead them to the right field instead of staying hidden inside a collapsed block.
Details That Are Easy to Miss
If a file upload field sits inside a collapsed section, test it after a file is selected and after the block is reopened. If a section uses conditional logic, test both states: when the extra field is hidden and when it is shown. If the same form is embedded on the page twice, test both instances. The plugin changelog includes fixes for multiple form instances, so that scenario should not be left untested.
After a test submission, check Entries, the admin notification, and the confirmation message. Collapsible Sections does not replace Gravity Forms notifications or confirmations, so the final validation is the same as with any other form: the entry is created, the email is sent, and the user gets a clear response after submission.
How to Verify the Result on the Site Without Missing a Form Error
Result verification should be a separate step. It is not there to answer "Does the form look good?" but "Can a real user complete and submit this request without losing anything?" That matters even more with collapsible sections because some fields may stay hidden until the user clicks.
Testing as a Visitor
Open the page in a private window so admin permissions and logged-in caching do not affect the test. Go through the form at a normal pace. Do not fill everything out correctly the first time. Intentionally skip one required field inside a collapsed section and click submit. The section with the error should be accessible for correction, and the error message should appear next to the field.
Then complete the form properly and submit it. Confirm that the Gravity Forms confirmation appears after a successful submission and that the entry is visible in Entries. If the notification email does not arrive, do not blame Collapsible Sections automatically. Gravity Forms notifications rely on the WordPress mail setup, so the real issue may be SMTP, the sender address, spam filtering, or the notification settings themselves.
Testing at Different Widths
Collapsible sections often look fine on a wide screen and unexpectedly crowded on mobile widths. Check that the section heading does not wrap in a way that pushes the expand icon out of place, that section images do not take up half the screen, and that the submit button is not too far from the last field. If sections feel overloaded, reduce image size, shorten descriptions, or choose a calmer style.
Testing with Cache and Optimization Enabled
After setup, turn the site's normal cache back on and repeat the test. If the optimization plugin combines or defers JavaScript, make sure section expansion still works correctly. The Collapsible Sections changelog includes fixes related to resource loading conditions and initialization, so on a live site you need to confirm that the required scripts are actually loading on the form page.
If the issue only appears after minification or deferred script loading, temporarily exclude Gravity Forms and JetSloth scripts from the problematic optimization inside the cache plugin settings. Do not do that blindly across the whole site. First confirm the symptom on the specific page, then add a targeted exclusion.
Result verification is considered complete when the form expands correctly, shows errors in the right sections, submits an entry, displays the confirmation, and keeps a normal appearance after cache is enabled.
Compatibility with WooCommerce, Conditional Logic, and Other Add-Ons
Collapsible Sections works inside the Gravity Forms ecosystem, so its behavior depends on the fields, add-ons, and workflows used in the form. On the JetSloth product page, the developer specifically mentions compatibility with Gravity Forms Product Add-Ons for WooCommerce. The changelog also includes fixes related to WooCommerce, GravityView, GravityFlow, the Signature field, conditional logic, Multiple Form Instances, and JetSloth's own add-ons. For a site owner, that translates into one simple rule: test complex combinations as combinations, not as isolated plugins.
WooCommerce and Product Forms
If Gravity Forms is being used as a set of product options, an accordion can make the product page cleaner. For example, the user selects a base option, expands additional settings, uploads a file, or enters personalization details. But you cannot sacrifice price clarity, required options, or the add-to-cart button. After enabling sections, test price recalculation, required fields, add to cart, and how the data appears in the order.
Do not bury critical paid options so deeply that the user no longer understands why the price changes. If an option affects price or production, the section heading should make that obvious: "Product Personalization," "Print File," or "Additional Options."
Conditional Logic
Gravity Forms can show and hide fields conditionally. The Section Break field has its own conditional logic behavior: if a condition is applied to the section, it affects the fields below it until the next section, page break, or the end of the form. Combined with Collapsible Sections, that is powerful but requires care. If the section itself is hidden, make sure the section body and nested fields disappear properly as well. If a field inside an open section is hidden, make sure the block height updates so you are not left with a large empty gap.
Pay especially close attention to required fields that appear conditionally. A user should not get an error for a field that is currently hidden. If that happens, first review the Gravity Forms conditional logic rules, then review your section settings.
Signature, File Upload, Rich Fields, and Visual Add-Ons
Complex fields sometimes initialize after the page loads or depend on a visible container. The Collapsible Sections release history includes fixes for the Signature field, enhanced UI dropdowns, multi-file upload fields, TinyMCE inside sections, and JetSloth's own visual add-ons. If your form includes fields like these, do not stop after testing a plain text field. Draw a signature, upload a file, select a value from an advanced dropdown, then reopen and close the section again.
If a field behaves inconsistently only inside a collapsed section, try opening that section by default, disabling single-open mode, or checking for a JavaScript optimization conflict. If the problem remains, look for a recent changelog entry or contact the developer's support with a specific reproducible test case.
Why Sections May Behave Incorrectly and How to Diagnose It
Troubleshooting works best when you move from simple checks to more complex ones. Do not change the theme, cache, CSS, and form structure all at once. First confirm the symptom on a test page, then narrow the scope: is the problem in a section setting, the form markup, conditional logic, a third-party script, or a specific field?
Sections Do Not Collapse and the Form Looks Like a Regular List
Symptom: the section headings are visible, but the fields are not grouped into expandable blocks. The user just sees one standard long form.
Possible cause: the plugin is not active, collapsible behavior is not enabled on the relevant sections, the form is using an old copy, or the page is rendering a different form.
What to check: open the form editor, select the Section field, and review the Collapsible Sections settings. Then make sure the page is displaying that exact form rather than an old shortcode or duplicate.
How to fix it: enable the mode on the correct sections, save the form, and refresh the page without cache. If the form is embedded through a builder, update the block or shortcode manually.
Fields Ended Up in the Wrong Section
Symptom: opening one section reveals fields from another, or regular fields are accidentally hidden inside the last block.
Possible cause: the section boundary is wrong. The last section did not close the previous group, and the next section did not start a new logical block.
What to check: review the field order in the editor from top to bottom. Find the first field that is "out of place" and inspect the section directly before it.
How to fix it: change the section mode so it starts a new block or closes the previous block. Then test the form again on the public page.
A Required-Field Error Is Hidden Inside a Closed Block
Symptom: the user clicks submit, sees a general error, but cannot tell where the missing field is.
Possible cause: the section with the error did not open after validation, a problematic single-open mode is enabled, custom CSS is hiding the error, or the form is conflicting with JavaScript optimization.
What to check: intentionally skip a required field in each section one by one. Make sure the error message is visible next to the field and that the section can be opened.
How to fix it: review the open-section settings, temporarily disable custom CSS and JavaScript optimization on the form page, and test again. If the symptom is tied to a specific field type, review the JetSloth changelog and the Gravity Forms documentation for that field.
Sections Stop Opening After Cache Is Enabled
Symptom: everything works for admins, but visitors cannot expand sections or they only open after a reload.
Possible cause: the cache plugin combined, deferred, or moved Gravity Forms and Collapsible Sections scripts. Sometimes this only affects logged-out users.
What to check: temporarily disable JavaScript optimization for the form page and compare the behavior. There is no need to reset the whole site's settings just to test the form page.
How to fix it: add a targeted exclusion for the form scripts or the form page itself. Then clear the cache and repeat the submission test.
The Section Design Breaks Inside the Site Theme
Symptom: section headings have odd spacing, icons are misaligned, an open block overlaps fields, or section images look excessively large.
Possible cause: the site theme is overriding .gsection, .gform_wrapper, or shared heading styles. Sometimes the conflict appears after adding custom CSS.
What to check: temporarily disable your custom Collapsible Sections CSS. Then, if it is safe to do so, test the form in a default theme or on a simple draft page without the complex layout.
How to fix it: use more targeted CSS rules for the specific form, reduce section image size, and do not hide error elements. If the issue comes from the theme, it is better to fix it in a child theme than to edit plugin files.
When It Is Better to Roll the Change Back
Roll the change back if, after enabling the accordion, users can no longer submit the form, required fields are unclear, the submit button is hidden, or troubleshooting takes more time than the new interface is worth. A temporary rollback does not mean the product failed. It is a sensible way to protect incoming submissions while you refine the form structure.
Questions About Setup and Collapsible Sections Limitations
Can I use the plugin on an existing form?
Yes. In fact, the main use case is adding new sections or updating existing Section Break fields. But for a live form, start with a copy or a test page. Make sure the fields fall into the right groups and that submission and notifications still work as expected.
Which is better: Collapsible Sections or Page Break?
If you want to keep the form on one page and simply reduce visual overload, use Collapsible Sections. If you need a multi-page process with navigation buttons, progress, and validation for each step, Page Break is usually the better choice. These approaches do not fully replace each other.
Can all sections be open by default?
Yes. The open-sections settings let you control the load state. That is useful when the accordion is being used as visual grouping rather than as a way to hide fields. But if every section is open, make sure you have not lost the plugin's main benefit: the form can easily become too long again.
Why do validation errors need separate testing?
Because a required field may sit inside a closed block. The user needs to see where the error is and how to fix it. Submit the form with one required field missing in each section and make sure the error message is not hidden.
Is the plugin suitable for WooCommerce products using Gravity Forms Product Add-Ons?
JetSloth states that it is compatible with that setup, and the changelog includes dedicated fixes for WooCommerce-related combinations. But product forms should be tested especially carefully: required options, price recalculation, add-to-cart behavior, and order data all need to keep working after sections are expanded.
Will the accordion affect page speed?
The plugin adds its styles and scripts only where the form needs them, and the changelog includes improvements to resource loading conditions. But actual performance still depends on the theme, cache, number of fields, section images, and third-party add-ons. Do not place large images in every heading unless there is a real reason, and always test the page again after cache is enabled.
Can I add a completed-section indicator?
The JetSloth documentation includes a JavaScript and CSS example for visually marking completed sections. Use that approach carefully: it does not replace real Gravity Forms validation, it only suggests that visible fields contain values. For critical forms, first confirm that standard submission and error handling work correctly without any extra script.
When might this product not be a good fit?
It may be unnecessary for short forms with only a few fields, for workflows where each step should live on a separate page, and for forms where legally important warnings should not be hidden behind expandable content. In those cases, it is usually better to simplify the form, use Page Break, or keep important fields permanently visible.
When Gravity Forms Collapsible Sections Is Worth Using
Gravity Forms Collapsible Sections is a strong choice if you have a long WordPress form that cannot be shortened much, but can be divided into clear logical blocks. The plugin is especially useful for service requests, registration questionnaires, matching forms, advanced contact forms, and WooCommerce product forms with additional options. It does not replace thoughtful structure, but it helps present that structure clearly to the user.
Before going live, check three things: section boundaries, error behavior, and compatibility with the page environment. Once those checks pass, you can move on to careful styling, section images, and additional guidance. If you are still preparing the site for testing, you can download Gravity Forms Collapsible Sections near the end of the page and try it on a copy of the form first.
The safest approach is not to chase a perfect design from the start. Build the form, test the workflow, fix the boundaries, validate error handling, and only then improve the appearance. That way, the accordion becomes more than a decorative layer - it becomes a real tool that helps people complete a long form with less friction.


