Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › GD library

How to Enable the GD Image Library for WordPress

By Freedom251 Team · · 9 min read

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

To enable GD for WordPress, load the gd PHP extension in the same PHP runtime that serves your site, restart or reload that runtime when required, and then verify the result at Dashboard > Tools > Site Health > Info > Media Handling. That panel shows whether WordPress can use GD, the GD version, and the image formats compiled into it. If Imagick is active, WordPress may use Imagick instead, even when GD is installed.

What the GD library does in WordPress

GD is a PHP graphics extension. WordPress uses it through the WP_Image_Editor_GD editor to create image sizes, generate thumbnails, rotate or crop pictures, and process uploads. The extension is part of PHP rather than a WordPress plugin or a setting in the WordPress dashboard.

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 the GD PHP library as included by default since PHP 4.3, so it is available in many hosting environments. “Available” does not necessarily mean enabled in the PHP handler serving your particular site, however. A host can run several PHP versions, disable extensions per account, or use a web PHP configuration that differs from the command-line configuration.

If GD is not loaded, changing Media settings in WordPress cannot install it. The PHP runtime, its build, or your hosting account must be changed first.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Check whether WordPress already sees GD

  1. Sign in to WordPress with an account that can view Site Health.
  2. Open Tools > Site Health.
  3. Select the Info tab.
  4. Expand Media Handling.
  5. Record the active image editor, the reported GD version, and the supported formats.

This is the authoritative WordPress-side check because it examines the PHP environment used by the site itself. Do not rely only on a command-line PHP check or on what your hosting control panel says. The web server may use a different PHP version, handler, or configuration file.

If Media Handling identifies GD and lists a version, WordPress can load the extension. If it identifies Imagick instead, GD might still be installed but is not the editor WordPress selected. If no GD version or format list appears, continue with the PHP and hosting checks below.

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

Understand the editor WordPress is using

GD as the selected editor

WordPress core checks that the gd extension is loaded and that the gd_info() function exists before selecting its GD editor. When those checks pass and GD is selected, WordPress uses WP_Image_Editor_GD for image operations.

Imagick instead of GD

WordPress can use Imagick when that extension is available and selected. In that situation, the presence of GD is not proof that GD is handling uploads. Check the active editor shown in Media Handling before troubleshooting a GD-specific behavior.

GD and Imagick at a glance

Question What WordPress can confirm
Which editor is active? Site Health > Info > Media Handling reports the active editor.
How is GD identified? WordPress requires a loaded gd extension and the gd_info() function before selecting WP_Image_Editor_GD.
Can GD be installed while Imagick is active? Yes. Imagick may be active while GD remains available as a fallback.
Which formats can GD process? The running GD build determines them, and Site Health lists the formats it supports.

There is no universal rule that one editor is always better. The practical choice depends on which extension your host enables, the formats exposed by that build, and the memory and performance limits of your PHP environment.

Before enabling GD, identify the PHP environment

Find the PHP version used by the website

Use the PHP version shown by your hosting panel or by WordPress Site Health, then make sure any change targets that exact version. A site running PHP 8.x through PHP-FPM can be unaffected by a GD extension enabled for an older PHP 7.x installation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

Distinguish web PHP from command-line PHP

Many servers have separate configurations for command-line PHP and the web server. A command-line report can show GD as loaded while the PHP handler serving WordPress has it disabled, or the reverse. Treat the Media Handling report in WordPress as the final test for the website.

Check whether you control PHP

  • Managed or shared hosting: You may be limited to a version selector or an extension checklist. The provider may have to enable GD for you.
  • Virtual or dedicated server: You can usually change the PHP installation, its modules, and the web-service configuration, subject to your operating system and PHP handler.
  • Local Windows installation: You normally edit the active php.ini and load the GD DLL, then restart the service that runs PHP.

The exact control-panel labels and restart procedure vary by provider, operating system, PHP version, Apache or Nginx setup, and whether PHP-FPM is used.

Enable GD on managed or shared WordPress hosting

When you cannot edit the PHP installation yourself, ask the host to enable the extension rather than changing WordPress files.

  1. Open the hosting panel’s PHP version, PHP extensions, or runtime settings area, if one is provided.
  2. Select the PHP version assigned to the WordPress domain.
  3. Enable the extension named gd or php-gd. Some panels expose it as a graphics or image-processing module.
  4. Apply the change and allow the provider’s PHP handler to reload. If the panel does not offer a reload control, wait for the host’s change to propagate.
  5. Return to Tools > Site Health > Info > Media Handling and check for a GD version and format list.

If the panel has no extension control, send support the domain, the PHP version, and a request to enable GD for the web PHP handler. Ask the provider to confirm which PHP handler serves the domain and whether the account is permitted to load the extension. WordPress documentation specifically notes that enabling extensions may require contacting the host or editing php.ini only where the environment permits it.

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

Do not assume that installing a WordPress image plugin will supply GD. Plugins can use an available editor, but they cannot load a PHP module that the server has disabled.

Enable GD in a self-managed PHP installation

PHP build options from PHP 7.4 onward

PHP’s installation documentation changed the build option name in PHP 7.4.0. The option --with-gd became --enable-gd, which controls whether GD is enabled at all. PHP also documents --with-external-gd when you want to use an external libgd instead of PHP’s bundled library.

Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

If you compile PHP, apply the option that matches your PHP version and build plan, then rebuild or install that PHP version and ensure the web handler uses it. A build change is not complete until the running web process has loaded the resulting extension.

Check GD’s build dependencies

GD’s format capabilities depend on the GD version and the libraries linked into the build. PHP’s requirements specify libgd 2.1.0 or higher, or PHP’s bundled GD, and note a zlib requirement of at least 1.2.0.4. Other format libraries and compile choices affect the final capability set.

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.

Because of those dependencies, do not assume that every GD installation supports JPEG, PNG, WebP, or another format. Read the supported-format list in Site Health after enabling the extension. If a required format is absent, the remedy is a PHP/GD build with the necessary libraries, not a WordPress media setting.

Attach the extension to the web PHP handler

After installing or rebuilding GD, make sure the PHP handler serving the domain loads that installation. PHP-FPM pools, Apache modules, and other handlers can point to different PHP versions. Reload or restart the relevant PHP service when your environment requires it; the service name and command are platform-specific.

Enable GD on Windows

  1. Locate the php.ini file used by the web server, not merely the one used by command-line PHP.
  2. Open the file and enable the GD extension entry for that PHP installation.
  3. For current Windows PHP builds, load php_gd.dll. Before PHP 8.0, the DLL was named php_gd2.dll.
  4. Save the configuration and restart the web server or PHP handler so it reads the changed file.
  5. Check WordPress’s Media Handling section and perform a real upload or edit.

The DLL name must match the PHP version and architecture installed on the server. If you edit a different php.ini than the one read by the web process, the change will appear to do nothing. Site Health is the simplest way to detect that mismatch.

Reload PHP after changing the extension

PHP reads extension settings when the relevant process starts. Depending on the server, that may mean restarting Apache, reloading PHP-FPM, restarting a Windows web service, or using a host panel’s apply button. There is no single command that works on every WordPress installation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

After the reload, refresh Site Health rather than relying on a cached dashboard page. If GD still does not appear, verify the PHP version, the active configuration file, the handler serving the domain, and whether the host blocks custom extensions.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Verify GD with a real WordPress operation

  1. Open Media > Add New and upload a normal image in a format listed as supported by GD.
  2. Open the uploaded item in the Media Library and confirm that WordPress creates its expected image metadata and sizes.
  3. Use an image edit operation such as a crop or rotation, then save it.
  4. Return to Site Health and confirm that the active editor and GD information remain present.

A successful upload alone is not conclusive if Imagick is active. Use the active-editor value to determine which library performed the operation. Testing a format that is absent from GD’s supported list can also produce a misleading failure; choose a format the running build explicitly reports.

Troubleshoot the most common GD errors

“GD library is missing” after enabling it

  • Confirm that you enabled GD for the PHP version assigned to the domain.
  • Check that the web server or PHP handler was reloaded.
  • Verify the active php.ini rather than a command-line configuration.
  • Ask the host whether extensions are restricted at the account level.

Command-line PHP reports GD, but WordPress does not

This normally indicates different PHP runtimes or configuration files. Compare the PHP version and handler used by the website, then have the provider confirm the web runtime. The WordPress Site Health result takes precedence over a CLI result for a WordPress diagnosis.

Imagick is active and you expected GD

WordPress may select Imagick when it is available. This is not necessarily an error. If you specifically need GD, confirm that GD is loaded and that your WordPress and hosting configuration allow it to be selected. If the task only requires image processing, test the active editor rather than forcing a particular library without a functional reason.

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

Only one image format fails

Inspect the supported-format list under Media Handling. GD capabilities vary with the GD/libgd build and linked libraries. A missing format points to a build-dependency or compilation issue, not an absent WordPress checkbox.

GD disappears after a PHP upgrade

PHP extensions are installed per PHP version. Upgrading PHP can leave the new runtime without the module that was enabled in the old one. Recheck the new runtime’s extensions, rebuild or install GD for that version, reload its handler, and verify Site Health again.

When to request host support

Contact the provider when you cannot select GD, cannot identify the web PHP configuration, or lack permission to install extensions. Include:

  • The domain and WordPress installation involved.
  • The PHP version reported for the site.
  • The exact Site Health path and what Media Handling currently reports.
  • Whether Imagick is active.
  • The image format or operation that fails.

Ask the provider to confirm that the gd extension and gd_info() are available to the web PHP handler, and to state which GD-supported formats are compiled into that runtime. This gives you a server-side answer instead of repeated WordPress setting changes.

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

Operational considerations after GD is enabled

Format planning

Use the formats displayed by Site Health as the capability contract for that server. If a workflow depends on a particular format, test it after every PHP or hosting change because GD capabilities are build-dependent.

Memory and processing limits

Image manipulation consumes PHP and server resources. The practical limit depends on image dimensions, concurrent requests, the active editor, and the host’s PHP limits. The available facts do not establish a universal memory threshold, so measure failures in your own environment and involve the host when large images time out or exhaust resources.

Keeping the configuration consistent

Document the PHP version, active editor, GD version, and supported formats shown in Site Health. Recheck them after PHP upgrades, migrations, or changes to the web handler. This prevents a working development configuration from being mistaken for the production configuration.

Key points to remember

  • GD is a PHP extension used by WordPress’s WP_Image_Editor_GD; it is not enabled from a WordPress media setting.
  • The definitive check is Tools > Site Health > Info > Media Handling.
  • PHP 7.4 and later use the --enable-gd build option; Windows loads php_gd.dll, while pre-PHP 8 Windows builds used php_gd2.dll.
  • GD format support depends on the GD/libgd build and linked libraries, including zlib; trust the format list reported by the running site.
  • Shared and managed hosts may need to enable the extension for you, and there is no universal hosting-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.

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

GD libraryimage uploadsPHPTroubleshootingWordPress

Leave a Reply

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

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.

Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

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.