SharePoint Document Issues

Fix SharePoint JSON Formatting Removing Grouped List View Headers

Kushani Nimanthika Sep 28, 2026 869 views

Question details

The user needs to resolve an issue where column headers in a SharePoint list disappear after applying JSON formatting to a view that is grouped and collapsed by default.

How to Fix Missing Grouped List View Headers in SharePoint JSON Formatting

Product: SharePoint Online
Device & OS: not provided
Scenario: Applying custom row JSON formatting to customize the appearance of a grouped SharePoint list view.
Observed behavior: The column headers vanish when the list group is set to 'collapsed by default'. This appears to be a SharePoint Online rendering bug rather than an invalid JSON code issue, as expanded groups display headers correctly.

Before you start

Verify that your JSON code is syntactically valid using an online JSON checker, and back up your current view formatting by pasting the code into a text editor before making any changes.

Solution 1Recommended

Isolate the Issue and Recreate the View

Determine if the missing headers are caused by browser caching, a corrupted specific list view, or a broader SharePoint site bug.

SharePoint caching or localized view corruption can sometimes cause interface elements like headers to disappear. By isolating the environment, you can confirm whether the JSON formatting or the SharePoint platform is at fault.

Test in a different browser

Open SharePoint Online in an alternative web browser (such as Edge, Chrome, or Firefox) or use an Incognito/Private window to rule out localized caching issues.

Remove and reapply formatting

Navigate to the affected list view, click the view dropdown menu in the top right, and select 'Format current view'. Delete the existing JSON, save the view, and then paste the JSON back to reapply it.

Create a test list view

Click the view dropdown and select 'Create new view'. Set your 'Group By' configuration to 'Collapsed' by default, and apply your JSON formatting to see if the problem persists in this fresh view.

Test on a completely new list

Create a new, blank SharePoint list on your site. Replicate the columns, set grouping to collapsed, and apply the exact same JSON snippet to confirm if it is a site-wide bug.

Group Expansion Workaround: Since this bug frequently triggers only when groupings are collapsed by default, temporarily modifying your view settings to expand groups by default may restore header visibility until a permanent fix is found.

Solution 2

Escalate to Microsoft 365 Support

If troubleshooting confirms the issue is a systemic SharePoint Online bug, you will need to open a support ticket with Microsoft.

Free Microsoft Office alternative

Looking for a Hassle-Free Way to Manage Office Documents?

While complex SharePoint formatting and Microsoft 365 backend issues can disrupt your workflow, standard document management shouldn't. WPS Office provides a lightweight, entirely free, and highly compatible alternative to Microsoft Office for your local and cloud document needs.

1. Download the installer: Visit the official WPS Office website and click the Free Download button.
2. Run the setup: Open the downloaded installer file and follow the on-screen prompts to install the suite on your device.
3. Start creating: Open WPS Office to instantly create, edit, and save highly compatible documents, spreadsheets, and presentations.

Seamlessly create and format documents before uploading them to collaborative platforms like SharePoint.Fully compatible with Microsoft Word, Excel, and PowerPoint formats (.docx, .xlsx, .pptx).Lightweight software architecture that opens rapidly without slowing down your computer.Familiar tabbed user interface allowing you to easily switch between documents, spreadsheets, and presentations.

microsoft office alternative - wps office

Frequently Asked Questions

Why do column headers disappear in my grouped SharePoint list?

This frequently occurs due to a known display bug in SharePoint Online when custom row JSON formatting is combined with views where groups are set to 'collapsed by default'. It is usually a rendering issue rather than an error in your JSON code.

How can I check if my SharePoint JSON is valid?

You can paste your code into any online JSON validator to check for standard syntax errors like missing commas or brackets. To test SharePoint-specific schema logic, the best approach is to apply the code to a completely new, blank test list.

Can I temporarily fix the missing header issue without removing the JSON?

Yes. If the issue is specific to collapsed groupings, go to your List View settings, scroll down to the 'Group By' section, and change the default state from 'Collapsed' to 'Expanded'. This often forces the headers to render correctly.

Document & File Issues