What iconv is and why it matters #
iconv is a PHP extension that helps PHP convert text between character encodings (for example, UTF-8 and other encodings). SolidWP products may rely on this capability when processing data that includes special characters, such as:
- filenames inside archives
- imported or exported data
- text that includes accented characters, emoji, or non-English characters
If iconv is not available, PHP cannot perform those conversions reliably, and related plugin features may fail.
Why SolidWP can’t enable iconv #
iconv is enabled at the hosting and server level, not inside WordPress.
That means enabling it requires access to your hosting environment (PHP configuration, installed PHP modules, or the server image). WordPress plugins cannot install or toggle PHP extensions.
The fastest path to a fix #
Step 1: Identify who controls PHP for this site #
- Managed hosting or shared hosting: the hosting provider controls PHP modules.
- VPS, dedicated server, or self-hosted: the site owner or server administrator controls PHP modules.
If there is no clear server administrator, treat this as a hosting provider task.
Step 2: Ask the host to enable iconv for the site’s PHP version #
Send this message to the hosting provider (or whoever manages the server):
Please enable the PHP iconv extension for this site. A WordPress plugin requires it.
Site: example.com
PHP version used by the site (if known): X.Y
PHP handler (if known): PHP-FPM / nginx / Apache
Please confirm iconv is enabled for the web PHP runtime serving the site (not only command-line PHP).
Why this matters: it is possible for iconv to be enabled for CLI PHP while still missing for the website.
What to expect after it’s enabled #
- The host may need to restart PHP (for example, PHP-FPM) for the change to take effect.
- After the host confirms it is enabled, re-run the action that failed (the backup step, import, export, etc.).
If the same error continues after the host enables iconv, the most common cause is that it was enabled for the wrong PHP version.
How to verify iconv is enabled #
Recommended verification: host confirmation #
Many WordPress environment screens do not provide a reliable “all PHP extensions” list. For most customers, the most dependable verification is:
Ask your host to confirm iconv is enabled for the PHP version serving this site over the web.
If the customer has server access (advanced) #
Verification should check the PHP runtime that serves web requests, not only CLI. The exact method depends on the server stack, so the host or server admin should choose the appropriate approach.
Common reasons this stays unresolved #
- Multiple PHP versions are installed and iconv was enabled on a version the site is not using.
- CLI vs web mismatch: iconv shows up in terminal checks, but the web server loads a different configuration.
- Hosting restrictions: some plans do not allow enabling specific modules. In that case, the realistic options are a different PHP build or version, or a different host.
If the host cannot enable iconv #
If the hosting provider says iconv cannot be enabled:
- Ask whether a different PHP version or build is available where iconv is included.
- If not, consider migrating the site to hosting that supports required PHP extensions.
