Section Background Does Not Save: Admin Checklist

When you set a section background on a SharePoint modern page, the change may not save. The background reverts to the default white or gray after you refresh the page. This problem occurs because of browser cache, unsupported image formats, or permission restrictions on the page library. This article explains the root causes of the background save failure and provides a step-by-step admin checklist to resolve it. You will also learn related issues and a comparison of the three common causes.

Why Section Background Changes Do Not Save

SharePoint modern pages store section background settings as a JSON property inside the page file. When you select a background image from the section formatting panel, SharePoint writes the image URL and alignment settings to the page. Three common factors stop this write operation from completing successfully.

Browser Cache Interference

Modern browsers cache the page layout and style data after the first load. When you change the section background and save, the browser may serve the cached version of the page instead of the updated version. This makes the background appear to revert even though the server stored the new setting.

Unsupported Image Format

SharePoint section backgrounds accept only JPEG, PNG, and GIF images. If you upload a WebP, BMP, TIFF, or SVG file to the site assets library and select it as the background, SharePoint does not reject the selection. The save operation completes without error, but the background does not display because the rendering engine cannot process the format. The page falls back to the default background.

Insufficient Page Library Permissions

The section background property is stored in the page item metadata. To modify this metadata, the user needs at least Contribute permission on the Site Pages library or the specific page library. Users with Read permission can open the page and view the formatting panel, but the save button does not write the change to the server.

Admin Checklist to Fix Section Background Save Issues

Follow these steps in order. Test the background after each step to identify the exact cause.

Step 1: Clear Browser Cache and Hard Reload

1. Open the browser settings menu
   In Chrome, Edge, or Firefox, click the three-dot menu in the upper-right corner. Select Settings > Privacy and Security > Clear browsing data.
2. Clear cached images and files
   Set the time range to All time. Check Cached images and files. Uncheck other items. Click Clear data.
3. Hard reload the page
   Press Ctrl+F5 on Windows or Cmd+Shift+R on Mac. This forces the browser to fetch all resources from the server.
4. Set the section background again
   Edit the page, open the section formatting panel, choose a background image, and click Save. Refresh the page to verify.

Step 2: Verify the Image Format

1. Check the image file extension
   Navigate to the site assets library where the background image is stored. Right-click the file and select Properties. Confirm the file extension is .jpg, .jpeg, .png, or .gif.
2. Convert unsupported formats
   If the image is .webp or .bmp, open it in an image editor like Paint or Photoshop. Export as JPEG or PNG. Upload the converted file to the site assets library.
3. Update the section background reference
   Edit the page, remove the old background, select the newly uploaded file, and save.

Step 3: Check and Grant Page Library Permissions

1. Navigate to the page library
   Go to the SharePoint site. Select Settings (gear icon) > Site contents. Locate the library that contains the page (typically Site Pages).
2. Open library permissions
   Click the three dots next to the library name and select Manage access. Click Advanced permissions settings.
3. Verify the user or group has Contribute or Edit
   Find the user who is trying to set the background. If they have Read permission, click Edit user permissions and select Contribute. Click OK.
4. Test the background change
   Ask the user to edit the page, set the section background, and save. Confirm the background persists after refresh.

Step 4: Use the SharePoint Page Diagnostic Tool

1. Install the SharePoint Page Diagnostic tool
   Go to the Chrome Web Store and add the SharePoint Page Diagnostic extension.
2. Run a scan on the page
   Open the page with the background issue. Click the extension icon and select Start scan. Wait for the report.
3. Look for background-related warnings
   Check the Customization section of the report. Any warning about unsupported CSS or image references points to the cause.

If Section Background Still Does Not Save

Section background works in edit mode but not on the published page

This indicates the page has a custom master page or alternate CSS that overrides the section background property. Check the site theme and master page settings. Go to Site settings > Master page and reset to the default Seattle master page. After resetting, reapply the section background and publish.

Background disappears after moving the page to another site

When you move or copy a page between sites, the image reference in the background property points to the source site. The destination site does not have access to that image. Move the image file to the destination site assets library first, then update the background reference on the page.

Background fails on a page created from a custom page layout

Custom page layouts may strip the section background JSON property during publishing. Open the page in SharePoint Designer and verify that the Page Layout field is set to a standard layout like Article.aspx or Blank.aspx. Avoid layouts that use the Minimal Download Strategy (MDS) feature.

Item	Browser Cache Issue	Unsupported Image Format	Permission Restriction
Description	Stale cached page data prevents the updated background from rendering	SharePoint cannot process the image file type so it ignores the background setting	User lacks write access to the page metadata where the background property is stored
How to test	Open the page in an InPrivate or Incognito window	Check the file extension in the site assets library	Check the user permission level on the page library
Fix	Clear cache and hard reload	Convert the image to JPEG or PNG	Grant Contribute permission on the library

After you complete the admin checklist, the section background should save and display correctly. For persistent issues, inspect the browser developer console for JavaScript errors when saving the page. If errors appear, disable any custom scripts or SharePoint Framework extensions on the site before retrying the background change.