Configuration Settings

General Settings

Enable Plugin

Type: Toggle
Default: Off

The ‘Enable Plugin’ setting toggle controls whether WP QuickDraw functionality is enabled on your site. This setting allows the plugin to remain activated in WordPress but disabled at the settings level. When the plugin is first installed, this setting defaults to OFF, meaning admins must manually enable the plugin to get started. This manual step is in place to allow admins a chance to review settings before initiating imageset generation..


Image Enhancement Behavior

Type: Slider
Default: Optimized

The ‘Image Enhancement Behavior’ setting slider controls numerous advanced configuration options, allowing a user to quickly set the degree to which they want their site’s images to intelligently display for visitors. The Aggressive option will use the most server bandwidth serving up images, while the Lazy option will use the least bandwidth.

Lazy: Enables deferred load, trigger type = hover, initial image state = low resolution image

Optimized: Enables deferred load, trigger type = scroll, initial image state = low resolution image

Aggressive: Disables deferred load, initial image state = low resolution image

See ExampleEnhanced Zoom

Type: Toggle
Default: On

The ‘Enhanced Zoom’ setting toggle controls whether or not WP QuickDraw’s enhanced zoom functionality is turned on. Enhanced Zoom will attempt to load a higher resolution version of an image when WP QuickDraw Pro detects that a mobile site visitor is attempting to zoom in on a WPQD-ified image. This functionality supports most mobile operating systems (iOS, Android, etc) and the setting is only available in the Pro version of the plugin.

See ExampleIntelligent Resize

Type: Toggle
Default: On

The ‘Intelligent Resize’ setting toggle controls whether or not WP QuickDraw’s intelligent resize functionality is turned on. When enabled, Intelligent Resize will detect changes to a browser window’s width and then serve up higher resolution versions of WPQD-ified images when the code detects the image is now showing at a larger width. This logic allows browsers to load small file size images in small browser windows but intelligently and responsively scale the images up with more pixels if the window is enlarged. Intelligent resizing of images can decrease server/CDN bandwidth usage by displaying the correct image size for an image container on page load, and then adding higher resolution photos if a window resize event is trigger.

See ExampleProgress Indicator

Type: Toggle
Default: Off

The ‘Progress Indicator’ setting toggle controls whether or not WP QuickDraw’s progress indicator functionality is turned on. One critique of progressive images in the past has been that site visitors would not necessarily know when an image was completely loaded. The WP QuickDraw progress indicator adds an indicator icon to the lower lefthand corner of an image that builds as the progressive quality versions of the image are applied. Once an image has completely loaded, the icon disappears.

See ExampleProgressive Fade Effect

Type: Toggle
Default: On

The ‘Progressive Fade Effect’ setting toggle controls whether or not WP QuickDraw’s patent-pending progressive fade effect functionality is turned on. The fade effect uses CSS opacity and contrast values to gradually fade an image into view as its resolution enhances. The effect has the power to make a visitor think the initial low resolution base image is a high resolution image and that it is just fading into view.

Advanced Configuration

Type: Toggle
Default: Off

The ‘Advanced Configuration’ setting toggle controls whether or not WP QuickDraw’s advanced configuration setting menu appears in the WordPress admin. The advanced configuration setting menu will appear as a new tab in the WP QuickDraw settings panel, and allows users to modify specific settings related to how the plugin intelligently renders site images.

Advanced Configuration

Note: For WP QuickDraw free installations, these settings are configured in a grouped manner by changing the Image Enhancement Behavior slider setting. WP QuickDraw Pro users can configure each setting separately.

See ExampleDeferred Load

Type: Toggle
Default: On

The ‘Deferred Load’ setting toggle controls whether or not WP QuickDraw’s deferred load functionality is turned on. When enabled, WPQD-ified base images will wait until triggered to enhance to load higher resolution versions. When enabled, images that load above-the-fold will automatically enhance, and below-the-fold images will enhance when triggered by the Trigger configured in the ‘Trigger Type’ setting. When disabled, all images will enhance on page load.

See ExampleTrigger Type

Type: Select
Default: Scroll

The ‘Trigger Type’ dropdown setting selector controls what trigger type is used to trigger image enhancement on below-the-fold images. The selector allows site owners to choose between page scroll detection and image hover detection as trigger options. If the scroll trigger type is selected, the scroll load sensitivity value can be configured using the ‘Scroll Load Sensitivity’ advanced configuration setting. The ‘Trigger Type’ setting has no effect if the ‘Deferred Load’ setting is disabled.

Scroll Load Sensitivity

Type: Input Field
Default: 0.25

The ‘Scroll Load Sensitivity’ advanced configuration setting defines the threshold from the bottom of the browser viewport to the top of image when deferred load image enhancement starts during scroll. The settings accepts decimal value between 0 and 1. The default value of 0.25 means that below-the-fold images are triggered to enhance when they come within 25% of the browser viewport height from the bottom of the viewport.

See ExampleInitial Image State

Type: Select
Default: Low Resolution Image

The ‘Initial Image State’ dropdown setting selector controls what the initial image state will be for WPQD-ified image on page load before they begin enhancing in resolution. The options available are Low Resolution Image, Placeholder Image, or Transparent (Spacer GIF). If Low Resolution Image is selected, a low resolution version of the image to be shown is displayed. If Placeholder Image is selected, a set placeholder image will be shown for all WPQD-ified images before enhancement starts. When selected, an additional advanced configuration option called ‘Placeholder Image’ appears allowing a site owner to specify their default placeholder image. If Transparent (Spacer GIF) is selected, a small transparent GIF image will be used to set the page layout before the enhancing image begins showing on the page. The Transparent (Spacer GIF) option often leads to the quickest completion of page layout rendering.

Javascript Support Load Message

Type: Toggle
Default: On

The ‘Javascript Support Load Message’ setting toggle controls whether or not WP QuickDraw’s Javascript support message functionality is turned on. When enabled, and when WP QuickDraw detects that Javascript is disabled in a visitor’s browser, the plugin will alerts users that are browsing a page with WPQD-ified images on it that they may not be getting the best user experience. The message provides a link to users to view the page with original non-WPQD-ified images embedded.

Custom SEO Bot User Agent Strings

Type: Text Area
Default: Custom SEO Bot User Agent Strings

The ‘Custom SEO Bot User Agent Strings’ advanced configuration setting controls which SEO Bots are shown a version of WPQD-ified pages with original source images rather than progressively enhancing images. The textarea accepts one value per line (default value “Industry Standard bots” will include most search engine crawlers).

Web Responsive Breakpoints

Type: Repeating Input Field
Defaults: 768, 1024, 1200, 2000

The ‘Web Responsive Breakpoints’ advanced configuration setting controls which browser width breakpoints will be used to generate progressive image sets. For each breakpoint provided, WP QuickDraw will generate the image files necessary to scale a low resolution base image up to a higher resolution image matching the breakpoint width. The setting is limited to a maximum of 6 breakpoints.


WP QuickDraw Pro Account

Type: Account Credential Inputs

Website owners who purchase a WP QuickDraw Pro license on the WP QuickDraw store at can plug in their username and password here to activate the Pro plugin features. For a full comparison of features available in WP QuickDraw Pro, please visit the comparison page.


Compatibility Check

Type: Button

During plugin installation, users may encounter a notification that their installation is not compatible with WP QuickDraw. In that case, they will be presented with a list of things they should change/configure to become compatible. Once a user has taken steps to become increase compatibility, they can click the ‘Compatibility Check’ button to re-check their system compatibility.

Regenerate Images

Type: Button

The ‘Regenerate Images’ button can be clicked to manually trigger regeneration of website WPQD images using current settings.

Reset Image Process Queue

Type: Button

The ‘Reset Image Process Queue’ button can be clicked to clear the image set process queue (this will cancel any imports currently in progress).

View Image Status

Type: Button

The ‘View Image Status’ button provides a link to see a detailed breakdown of images & if they have been processed by WP QuickDraw.

Image Status

When WP QuickDraw is installed and activated, a ‘WPQD Image Status’ menu item will appear in the WordPress Tools menu. The image status dashboard provides in-depth insights into WP QuickDraw’s image set generation status. From the dashboard, you can check on how many images have been converted and see if any generation processes have run into issues. By default, the WPQD will attempt to generate image sets for a given image three times before skipping an image.