Configure uploads and attachment pages
These five independent controls are for site administrators. Open Settings → POM Tweaks → Media. Enable only the controls you need, configure them, and select Save. Media library continues to contain Image optimizer and Media renamer.
Configure uploads
Open Media → Uploads.
| Control | Configuration and result |
|---|---|
| SVG uploads | Sanitize new SVG uploads and sideloads before publishing the file; display dimensions from the SVG rather than a fixed square. |
| Default image quality | Set Image quality from 0 to 100; the default is 82. WordPress treats 0 as 1. Applies when WordPress encodes an image using its default quality. |
| Maximum upload size | Enter Maximum upload size (bytes) as a nonnegative whole number. 1048576 bytes equals 1 MiB. Zero or empty keeps existing limits. |
- Enable the relevant control and save its values.
- Upload a representative file through Media → Add Media File.
- Check the file in Media → Library, including its dimensions and appearance.
- For a size limit, try files just below and above the limit. The larger file should be rejected.
SVG uploads require upload permissions. Multisite networks must also include svg in their allowed upload file types. SVG processing has a 10 MiB ceiling, rejects malformed XML and document type declarations, and uses an SVG sanitizer to remove unsafe markup. Remote-reference removal is enabled. Export a self-contained SVG; linked images, fonts, scripts, or other removed content can change its appearance. Review the result before using it. Compressed SVGZ files are not enabled. Existing SVG files are not sanitized retroactively.
Image quality does not recompress existing files. A separate optimizer that explicitly supplies its own encoding quality can take precedence. The upload limit cannot raise PHP or network ceilings, available network storage, or restrictions imposed by your web server or proxy. The server checks normal uploads and WordPress sideloads as well as the browser uploader.
Configure attachment pages
Open Media → Attachment pages. An attachment page is a WordPress page about a media item; it is separate from the image or download URL.
| Control | Choices and result |
|---|---|
| Attachment pages | Show a 404 page returns HTTP 404 through the theme's normal error template. Redirect to parent sends HTTP 301 to the attachment's published, publicly viewable parent. |
| Attachment fallback | With Redirect to parent active, choose Redirect to media file or Redirect to home page when no public parent is available. |
- Enable Attachment pages, select its behavior, and save.
- If using parent redirection, enable Attachment fallback and select a destination if required.
- Open an attachment page associated with a published parent and an unattached media item.
- Verify the expected error page or destination. Open the direct file URL separately: it remains available. To disable attachment comments, open Content → Comments, enable Disable comments by post type, select Media (attachment), and save. This closes discussion and hides its native panels and displayed comments without deleting records. Other unselected post types keep their existing behavior.
Draft, private, password-protected, deleted, and attachment parents do not qualify as public parent destinations. Without an enabled fallback, these requests retain the site's normal WordPress behavior. The fallback has no effect while Attachment pages is disabled or set to Show a 404 page. Feeds, previews, and API requests are excluded from attachment-page redirection.
While Attachment pages is active, the classic media modal removes attachment-page link choices. An attachment-page link selected in a media or gallery settings view becomes a file link. Existing saved content is not rewritten. Block editor controls and custom builders can provide their own link choices.
Troubleshooting and reversal
- SVG refused: check the network's allowed types, the 10 MiB ceiling, valid SVG XML, and upload permissions. Try exporting plain, self-contained SVG.
- SVG looks different: the sanitizer may remove active or externally linked content. Compare with the original artwork.
- Large files still fail: the lowest effective server, network, storage, or configured limit wins.
- Parent redirection uses the fallback: confirm the parent is published, publicly viewable, and not password protected.
- Unexpected redirect instead of a 404: review site-wide 404 redirects, SEO plugins, caching, and theme behavior. A 301 may remain cached by the browser or CDN.
Disable the relevant control and save to stop its future behavior. WordPress may still redirect attachment pages to files through its own setting. Disabling SVG support does not remove already uploaded files or restore markup removed during sanitization. Keep the original artwork. Changing image quality does not restore previously encoded images.