"Site Upload Quota Space" should indicate network default and possibly site's current usage

[MadtownLems]

In Multisite, there is a network default site quota which can be overridden on individual sites by visiting /wp-admin/network/site-settings.php?id=BLOG_ID

It says:
Site Upload Space Quota (input box here) MB (Leave blank for network default).

It would be incredibly helpful to have easy access to two other pieces of information here.

1) The network default.

This could be shown as: (Leave blank for network default: 2500 MB)

2) The site's current use.

This could be shown as. (Leave blank for network default: 2500 MB) (Space currently used: 100 MB)

Each of these pieces of information would really help in editing sites to change the storage quota. I'd suggest the network default is more important, and if only one were to be added, that should be it.

This pull request fixes the issues descripted in the ticket Trac ticket: [](https://core.trac.wordpress.org/ticket/60549)
In superadmin 'Edit site' page:

1. Shows the network default Site upload space
2. The site's current use.

and also displays space usage information to the sub site administration in the media gallery pages.

This update introduces a new function, get_space_usage(), which enhances the way WordPress reports upload space usage for a site. The function calculates the space used for uploads and provides a detailed or simplified report based on whether the upload space check is enabled or disabled.

When upload space check is disabled: The function returns a simple message showing the space used in megabytes (e.g., "500 MB Space Used").

When upload space check is enabled: The function provides a more detailed report, including the percentage of space used and the total space allowed (e.g., "Used: 500 MB (50%) of 1 GB").

This enhancement improves transparency and usability for site administrators by offering clearer insights into their site's storage usage. The function also uses localization-friendly strings, ensuring compatibility with multilingual setups.

Technical Details:

The function get_space_usage() leverages existing helper functions like get_space_used(), get_space_allowed(), and size_format() to calculate and format the space usage.

The function respects the upload_space_check_disabled site option to determine the level of detail in the output.

This change is backward-compatible and does not affect existing functionality. It is particularly useful for multisite networks where storage management is critical.
The following images show the visual changes to the various pages.

In "Edit site"

In 'Dashboard'
Before the suggested changes, when the upload_space_check_disabled site option was enabled, the admin had no information about the storage space.

After the suggested changes:

In 'Media Gallery'

In media upload pages

[joemcgill]

Adding to the 6.8 milestone for visibility.

[MadtownLems]

I like all of these inclusions except the one at the top of the Media Library. Users already complain frequently about too many notices at the top of their admin screens; I don't think we should contribute to that problem. Thank you for putting this together!

[lenasterg]

Replying to MadtownLems:

I like all of these inclusions except the one at the top of the Media Library. Users already complain frequently about too many notices at the top of their admin screens; I don't think we should contribute to that problem. Thank you for putting this together!

Hi.
I understand the concern about notices at the top of the Media Library. However, it’s placed where users expect to find storage-related information, making it easier to manage upload space without having to navigate elsewhere. I believe it provides value by being contextually relevant rather than disruptive.

I added some commits to fix a handful of WPCS issues.

Phew, all the coding standard issues are now fixed 😅

[audrasjb]

As per today's bug scrub: It appears this ticket is still needs user testing. As 6.8 beta 1 is very close, I'm moving it to 6.9. Feel free to move it back to 6.8 if it can be committed by Monday.

[MadtownLems]

I understand the concern about notices at the top of the Media Library. However, it’s placed where users expect to find storage-related information, making it easier to manage upload space without having to navigate elsewhere. I believe it provides value by being contextually relevant rather than disruptive.

My suggestion is to only display it here when the quota is approaching full. There's little value in mentioning the space quota if they're using, say, 5% of it. I would definitely argue that's it's disruptive, rather than helpful, in that case. Perhaps if it was only displayed when it's becoming a concern; something like when 90% or more of the site's storage space is used.

[lenasterg]

Hi.

If I understand correctly, your only concern is that it appears as a notice in the Media Gallery.
This is easy to change in the proposed patch.

Would you agree if I remove the following from the proposed patch?

add_action( 'load-upload.php', 'upload_page_notice_display_space_usage_notice' );

​https://github.com/WordPress/wordpress-develop/blob/140d05bdce4ee58aeffabe3ef41d11041bfed248/src/wp-admin/includes/ms-admin-filters.php#L13

Along with the related functions:

• upload_page_notice_display_space_usage_notice()
• display_space_usage_notice()

​https://github.com/WordPress/wordpress-develop/blob/140d05bdce4ee58aeffabe3ef41d11041bfed248/src/wp-admin/includes/ms.php#L281

What do you think, about it?

Replying to MadtownLems:

I understand the concern about notices at the top of the Media Library. However, it’s placed where users expect to find storage-related information, making it easier to manage upload space without having to navigate elsewhere. I believe it provides value by being contextually relevant rather than disruptive.

My suggestion is to only display it here when the quota is approaching full. There's little value in mentioning the space quota if they're using, say, 5% of it. I would definitely argue that's it's disruptive, rather than helpful, in that case. Perhaps if it was only displayed when it's becoming a concern; something like when 90% or more of the site's storage space is used.

[SirLouen]

Patch Test Report

Description

❌ This report can't fully validate that the indicated patch works as expected.

Patch tested: ​https://github.com/WordPress/wordpress-develop/pull/8303.diff

Environment

• WordPress: 6.9-alpha-60093-src
• PHP: 8.2.28
• Server: nginx/1.27.5
• Database: mysqli (Server: 8.4.5 / Client: mysqlnd 8.2.28)
• Browser: Chrome 135.0.0.0
• OS: Windows 10/11
• Theme: Twenty Fifteen 4.0
• MU Plugins: None activated
• Plugins:
  • Test Reports 1.2.0

Patch Testing Reproduction Steps

1. Here are the places where the content should be seen:

• /wp-admin/network/site-settings.php?id=<blog_id>
• /wp-admin/ ⇒ Individual Site Dashboard > At a Glance Widget
• /wp-admin/upload.php ⇒ As a Notice
• /wp-admin/upload.php ⇒ Inside Media > Add Media File button
• /wp-admin/media-new.php

2. Check Network Settings > Site upload space

Expected Results

• Used Space, and, remaining space should be displayed in all 5 areas

Actual Results

• ✅ The text can be seen in all these 5 areas
• ✅ If the Site Site upload space is checked and filled, it displays the right information in all areas
• ❌ If the Site Site upload space is checked but not filled there is an issue, check notes

Additional Notes

1. The only error I've found is that when Site upload space is not filled, it doesn't display default 100 MB in this section:

2. Regarding this suggestion I have provided some ideas within the ​PR 8303

[ideag]

• ❌ If the Site Site upload space is checked but not filled there is an issue, check notes

This was fixed with the latest commit - it now respects and shows the default value for the option

[SirLouen]

Design Feedback Needed

@ideag now everything is working, but I believe, as many others have stated, that the notice is too much in wp-admin/upload.php

Personally, I would opt to remove it or, at best, just add that notice when it drops under certain fixed % (say for example 10%), configurable via filter hook.

[realloc]

Thanks everyone for the great work on this enhancement. It’s a very helpful addition for multisite administrators.

I’d also like to suggest going the last few meters and refining the Media Library notice:

Instead of always displaying it, it could appear only when a defined threshold is reached. This would keep the interface clean for most users while still drawing attention when action is needed.

[lenasterg]

Hi.

Thanks for the positive feedback and the thoughtful suggestion!

I’d suggest displaying the notice only when a site’s available upload space drops below 25% of its total quota. This way, users receive a warning only when it’s truly relevant, avoiding unnecessary clutter for those who still have plenty of space.

A suggestion to do it by using the built-in get_space_used() and get_space_allowed() functions. To make the notice as unobtrusive as possible, it should be shown only on the Media Library admin page (upload.php) and only for subsites, not the main site.

A suggestion to do it:

/**
 * Display a warning notice in the Media Library admin page
 * when the available upload space is less than 25% of the total quota.
 *
 * Applies only to subsites in a WordPress Multisite installation.
 */
add_action('admin_notices', 'custom_disk_space_warning');

function custom_disk_space_warning() {
    global $pagenow;

    // Only show notice on the Media Library page
    if ($pagenow !== 'upload.php') {
        return;
    }

    // Skip the main site (usually has no quota restrictions)
    if (!is_main_site()) {
        /**
         * Get the total and used upload space for the current site.
         * Both values are in megabytes (MB).
         */
        $space_allowed = get_space_allowed(); // Total quota (MB)
        $space_used    = get_space_used();    // Used space (MB)

        // Ensure quota is set and check if usage exceeds 75%
        if ($space_allowed > 0 && ($space_used / $space_allowed) >= 0.75) {
            // Display warning notice if remaining space is below 25%
            echo '<div class="notice notice-warning"><p><strong>Warning:</strong> You have used more than 75% of your available upload space.</p></div>';
        }
    }
}

This implementation ensures that the warning is shown only when needed, and only in the appropriate context, providing a better and less intrusive experience for multisite administrators.

Thanks again for raising this—refinements like these really help improve usability at scale.

Replying to realloc:

Thanks everyone for the great work on this enhancement. It’s a very helpful addition for multisite administrators.

I’d also like to suggest going the last few meters and refining the Media Library notice:

Instead of always displaying it, it could appear only when a defined threshold is reached. This would keep the interface clean for most users while still drawing attention when action is needed.

[realloc]

@lenasterg Did you add this to your PR?

[lenasterg]

No, I'm still in holidays without laptop.
If you want and have time please do so.

Replying to realloc:

@lenasterg Did you add this to your PR?

[welcher]

Tomorrow is 6.9 Beta 1 and there hasn't been any movement so I'm going to punt it to 7.0