All settings live under Settings → SVG Support in your WordPress dashboard. Sensible defaults are in place — most sites only ever touch Advanced Mode.
Basic settings
| Setting | What it does |
|---|---|
| Restrict SVG Uploads to | Select which user roles may upload SVG files. SVGs are XML code, so letting untrusted users upload them poses real security risks — keep this limited to administrators unless you know what you're doing. |
| Do not sanitize for these roles | Roles selected here bypass SVG sanitization on upload. Only bypass for roles you fully trust — e.g. if a trusted designer's hand-crafted SVGs are being altered by the sanitizer. |
| Sanitize SVG on Front-end | Sanitizes SVG output on the front end as well, adding defense in depth against XSS and injection attacks. |
| Minify SVG | Automatically minifies every SVG on upload, shrinking file size. |
| Load frontend CSS | Loads a very small piece of CSS that helps SVGs display correctly on the front end in some themes. |
| Enable Advanced Mode | The gateway to inline rendering and the options below. You don't need it to simply use SVGs as images — leave it off unless you use the advanced features, since it adds a small JS file to your front end. |
Advanced settings (visible when Advanced Mode is on)
| Setting | What it does |
|---|---|
| CSS Class to target | The class the plugin looks for when swapping img tags for inline SVG code. Default is style-svg; set your own (e.g. inline-svg) if you prefer. The plugin traverses any depth below an element carrying the class. |
| Skip Nested SVGs | When enabled, only the first SVG in a .style-svg container is inlined. Useful for Gutenberg Cover blocks that have SVG images nested inside them. |
| Output JS in Footer | Enqueues the plugin's JS before the closing </body> tag instead of in the head. Footer is usually the right choice; requires your theme to call wp_footer(). |
| Use Vanilla JS | Uses the dependency-free vanilla JS file instead of the jQuery version. |
| Use Expanded JS | Enqueues the readable, non-minified JS file — useful if a caching/minification plugin bundles and minifies your scripts externally. |
Legacy settings
| Setting | What it does |
|---|---|
| Force Inline SVG | Use with caution. Adds the target class to all img tags with SVG sources in the rendered HTML, inlining every SVG on the site. Handy when a page builder (e.g. Divi) won't let you add a CSS class to an image. |
| Automatically insert class | (Classic Editor only) Inserts the target class into img tags automatically when you embed an SVG in a post, and strips the default WordPress classes. Only affects SVG files. |
Danger zone
| Setting | What it does |
|---|---|
| Delete Plugin Data | When checked, all of the plugin's data is removed if you uninstall it. Leave unchecked to keep settings through a reinstall. |
In-dashboard help: the settings page also has a Help tab (top right of the screen) covering all of this, right where you need it.