Docs
Everything the plugin does, with copy-paste examples. Quick Maps is one shortcode, one widget, one small settings page, and four developer filters — this page covers all of it.
The shortcode
Wrap any location Google Maps can find:
[quick-maps]Orlando, Florida[/quick-maps]
The content between the tags is the map query. All of these work:
[quick-maps]One Infinite Loop, Cupertino, CA 95014[/quick-maps]
[quick-maps]Magic Kingdom, Florida[/quick-maps]
[quick-maps]Eiffel Tower[/quick-maps]
Sizing a map
Use the width and height attributes. Bare numbers are treated as pixels; CSS units pass through:
[quick-maps height="500px"]Magic Kingdom, Florida[/quick-maps]
[quick-maps width="100%" height="350"]Sanford, FL[/quick-maps]
Values are validated — a numeric value becomes px, anything unsafe falls back to the default. Width defaults to 100% so maps are responsive out of the box.
Global defaults
Under Settings → Quick Maps you can set a default address, default width, default height, and default zoom level. A bare [quick-maps][/quick-maps] with no content renders the default address — useful when the same office location appears across many pages.
The widget
Quick Maps ships a classic widget: Appearance → Widgets → Quick Maps. Drop it in any sidebar or widget area, give it a title and an address.
Performance behaviour
The plugin enqueues no JavaScript and no CSS. The only output is the map iframe itself, which carries loading="lazy" (the browser doesn’t fetch the map until it nears the viewport), allowfullscreen, and a descriptive accessible title. There is nothing to optimize, defer, or exclude in your caching plugin.
Developer filters
Four filters for code-level control:
| Filter | Purpose |
|---|---|
quickmaps_shortcode_tag |
Rename the shortcode tag itself (e.g. to migrate from another plugin’s tag). |
quickmaps_default_width |
Override the default width programmatically. |
quickmaps_default_height |
Override the default height programmatically. |
quickmaps_default_content |
Override the default address when the shortcode has no content. |
Example — make every map 400px tall site-wide unless the shortcode says otherwise:
add_filter( 'quickmaps_default_height', fn() => '400px' );
Requirements
WordPress 6.0+, PHP 7.4+. Tested up to WordPress 7.0. No Google account of any kind is needed — see why no API key is required.