Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
VGSources
Blog

How to Enable the GD Image Library for WordPress

Enable the GD PHP extension in the runtime serving WordPress, then verify the active editor, GD version and supported formats in Tools > Site Health > Info > Media Handling.
Length8 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Enable the gd PHP extension in the PHP runtime serving your WordPress site, then verify it in Dashboard > Tools > Site Health > Info > Media Handling. That screen reports the active image editor, the GD version, and the formats compiled into the running PHP installation. If Imagick is active, WordPress may use it instead of GD; changing a WordPress setting cannot load a missing PHP extension.

What the GD image library does in WordPress

GD is a PHP graphics extension that WordPress can use to resize, crop, rotate and otherwise process images. WordPress connects GD through the WP_Image_Editor_GD class. Image uploads, generated thumbnails and edits in the Media Library depend on an image editor that is available in the web server’s PHP runtime.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

WordPress documentation describes GD as included by default since PHP 4.3, so it is present on many hosting environments. “Included by default” does not mean that every current hosting account has the extension loaded: providers can disable extensions, install several PHP versions with different modules, or prevent customers from editing the PHP configuration.

WordPress can also use Imagick. When Imagick is selected and working, GD may be installed but not be the editor handling your images. The relevant question is therefore not only whether a server has GD files, but whether the PHP process used by WordPress has a working gd extension and whether WordPress selected it.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

Check whether WordPress already sees GD

  1. Sign in to the WordPress administrator dashboard.
  2. Open Tools > Site Health.
  3. Select the Info tab.
  4. Expand Media Handling.
  5. Read the entries for the active image editor, GD version and supported formats.

Site Health is the authoritative check for this site because it examines the PHP runtime used by the WordPress web request. It is more useful than checking a command-line PHP installation or looking for a library file in a server directory.

If the report names GD and displays a version, the extension is loaded. The supported-format list is equally important: it shows what that specific GD build can manipulate. Do not assume that JPEG, PNG, WebP or another format is available simply because GD exists.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What a healthy result looks like

  • An image editor is listed rather than an error saying that no editor is available.
  • The Media Handling section includes a GD version when GD is the active editor or available to WordPress.
  • Supported formats reflect the formats compiled into that installation.
  • A normal Media Library upload can create the expected image sizes.

When the report names Imagick

If Site Health identifies Imagick as the active editor, WordPress is currently processing images through Imagick. GD can still be installed as a fallback, but enabling it will not necessarily change the active editor. Use the reported editor and format list when diagnosing an upload or thumbnail problem.

Enable GD when you control the PHP installation

The extension must be enabled in the PHP runtime that serves the website. The exact file and service-reload procedure varies by operating system, PHP version, PHP handler and hosting provider, so there is no single control-panel sequence that applies everywhere.

Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

Linux and other builds configured from source

PHP’s build option changed in PHP 7.4.0. Older documentation may show --with-gd; PHP 7.4 and later use --enable-gd to enable the extension. PHP also documents --with-external-gd when a build should use an external libgd rather than PHP’s bundled GD.

Those options are build-time settings, not WordPress settings. A PHP administrator must rebuild or install a PHP package that contains GD, then make sure the web-server PHP handler uses that build. If several PHP versions are installed, enabling GD for one version does not enable it for the others.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Windows PHP installations

On Windows, load the GD extension through php.ini. For PHP 8.0 and later, the DLL is named php_gd.dll. Before PHP 8.0, the file was named php_gd2.dll. The name in the configuration must match the DLL supplied with that PHP version.

After changing php.ini, reload the PHP process used by the website if the environment requires it. A command-line PHP process may read a different configuration file from the web server, so a successful command-line check does not prove that WordPress can use GD.

Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

Account for GD’s format dependencies

GD’s capabilities depend on the GD version and the libraries linked into the PHP build. PHP’s requirements documentation specifies libgd 2.1.0 or higher, or PHP’s bundled GD, and notes a zlib requirement of at least 1.2.0.4. These dependencies affect which formats are compiled in and available to applications.

WordPress exposes the practical result in Site Health. Treat the supported-format list as the final answer for the running site instead of relying on a generic list of formats from a tutorial. Two servers can both report GD while offering different format support because they were built with different libraries or options.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Why one format may fail while another works

A site can successfully process one image type and fail on another when the corresponding support was not compiled into GD. For example, a working JPEG thumbnail does not establish that WebP support exists. Check the Media Handling list before changing WordPress code or replacing an image.

Reload PHP after the change

PHP configuration changes are not always picked up by an already-running service. Reload or restart the PHP service, PHP handler or hosting application according to the operating system and provider’s instructions. The correct action depends on whether the site uses a module, a FastCGI process, a pool manager or a managed platform; use the provider’s documented procedure rather than applying an unrelated command.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

On managed or shared hosting, customers often cannot edit php.ini or restart the PHP handler. In that case, ask support to enable the gd extension for the exact PHP version and handler assigned to the WordPress site. Include the domain, PHP version shown by the host and the Site Health Media Handling result so support can check the correct runtime.

Verify GD with a real WordPress operation

  1. Return to Tools > Site Health > Info > Media Handling and confirm that the expected editor, GD version and formats are now shown.
  2. Open Media > Add New and upload a normal image in a format listed as supported.
  3. Open the uploaded item and use an available image edit operation, such as a crop or rotation.
  4. Check the attachment’s generated sizes and confirm that the edited result saves without an editor or memory error.

This test checks the complete path: the web PHP runtime, WordPress’s editor selection, GD’s compiled format support and the site’s ability to write the generated files. A configuration change is not complete until this path works.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot a “GD library missing” message

Site Health does not list GD

First determine whether another editor is active. If Imagick is listed, GD may simply not be the selected editor. If no usable editor is listed, the gd extension is either absent, disabled or unavailable to the web PHP process.

WordPress core checks that the gd extension is loaded and that gd_info() exists before selecting WP_Image_Editor_GD. If those checks fail, installing a plugin or changing a Media Library setting cannot enable GD. The PHP runtime or hosting account must be changed.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

GD was enabled for the wrong PHP runtime

A common mismatch occurs when GD is enabled for the PHP binary used in a terminal but not for the PHP handler serving HTTP requests. Recheck Site Health after the change. If the web report is unchanged, ask the provider which PHP version and handler execute the site and request GD for that runtime.

The extension is enabled but the site still reports the old state

  • Confirm that the edited php.ini belongs to the web PHP process, not only the command-line process.
  • Check that the configured DLL name matches the PHP version on Windows.
  • Reload or restart the relevant PHP service or handler.
  • Verify that the hosting account permits the extension for the selected PHP version.
  • Reopen Site Health after the service has reloaded.

Only certain image formats fail

Inspect the supported-format list under Media Handling. If the failing format is absent, the GD build lacks the required support or linked library. The remedy is a PHP/GD build that includes the needed capability, or an alternative active editor that supports the format. Do not describe the problem as a completely missing GD library when GD is present but format support is limited.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Uploads work but resizing or editing fails

Confirm that the active editor is still available and that the source format appears in the supported list. If the editor changed after a PHP update, Site Health will show the new selection. If GD is active and the format is listed, provide the exact WordPress error and hosting PHP details to the provider; the remaining cause may be a server resource or file-permission problem rather than extension loading.

GD and Imagick: what WordPress is actually comparing

GD and Imagick are PHP image editors that WordPress can select. The practical comparison for a site owner is availability in the active PHP runtime and the formats that the selected build reports, not a universal claim that one is always faster or uses less memory.

Question GD Imagick
WordPress integration Uses WP_Image_Editor_GD when WordPress detects the gd extension and gd_info(). Can be selected when the Imagick PHP extension is available and passes WordPress’s editor checks.
How to confirm it is active Tools > Site Health > Info > Media Handling reports GD and its version. The same Media Handling section identifies Imagick when it is the active editor.
Format availability Depends on the GD version and linked libraries; Site Health lists the formats compiled into the running build. Depends on the installed Imagick extension and its underlying image delegates; confirm the formats reported by the active installation.
Where it can be enabled Must be loaded in the PHP runtime serving WordPress; a host may need to enable it. Also requires a PHP extension enabled by the host or server administrator.

WordPress may use Imagick even when GD is installed. Conversely, GD can be the available fallback when Imagick is absent. Base the decision on the editor that Site Health reports and on the formats your site actually needs.

Managed and shared hosting: the support request to send

When the host controls PHP, a concise request prevents the most common back-and-forth. Ask support to:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Confirm the PHP version and handler serving the WordPress site.
  • Enable the gd extension for that exact runtime.
  • Confirm that gd_info() is available.
  • Report the GD version and compiled image formats.
  • Reload the PHP service and tell you when the change is active.

After support responds, verify the result in WordPress Site Health rather than relying only on the support message. If the report still lacks GD, send a screenshot or copied Media Handling output and ask the provider to check for a different PHP runtime behind the web server.

Key facts to keep with the fix

  • GD is a PHP extension used by WordPress for image manipulation through WP_Image_Editor_GD.
  • The authoritative WordPress check is Tools > Site Health > Info > Media Handling.
  • PHP 7.4 and later use --enable-gd at build time; Windows loads php_gd.dll, while pre-8.0 Windows PHP used php_gd2.dll.
  • Format support is build-dependent and can rely on libgd and zlib versions.
  • Shared and managed hosts may need to enable GD for you, and there is no universal host-panel procedure.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.