Error Codes

Why am I receiving error code 0?

An error code 0 is usually related to a timeout configuration issue on your origin server. The image may not be able to be optimized in the allotted time that is defined in the timeout setting therefore you will receive a code 0 similar to this.


To fix this, you must increase the max_execution_time in your php.ini file. It is likely it is currently set at 30 seconds, however you will want to increase this value so that the system does not timeout during the optimization of large images. We recommend the following setting:

max_execution_time = 180

Alternatively, if setting the max_execution_time does not work, your firewall may be blocking the Optimus servers. In that case, try whitelisting the following IPs on your origin server.

Why am I receiving error code 204?

Error code 204 appears when there is an error with the image or it is broken. Try re-exporting the image or rebuilding the image to fix this error.


Why am I receiving an “Internal Error”?

There are a few reasons you could be receiving an Internal Error.

  • If an image and ALL of its variations are removed from the filesystem however it still exists in the database, Optimus will return an internal error message.
  • Any PHP error is also shown as internal error. There may be a configuration conflict with another plugin or your theme’s files.
  • Since WordPress 3.5, the Media Uploader settings have been removed from the WP admin dashboard however are still configurable by defining their path in your wp-config.php file. For example:
    define( 'UPLOADS', 'wp-content/'.'files' );

    This would place the uploads directory in wp-content/files rather than the default location wp-content/uploads. Check that you have properly defined your uploads path so that Optimus can properly reference and optimize your images.

To further debug this issue, modify your wp-config.php file to reflect the following.


define('WP_DEBUG', false);


 define('WP_DEBUG', true);
 define('SAVEQUERIES', true);
 define('WP_DEBUG_LOG', true);
 define('WP_DEBUG_DISPLAY', true);
 error_reporting(E_ALL | E_STRICT);
  • Heike Kurtz

    Since I am not a computer nerd: where do I find this php.ini file?

    • If you’re using Nginx it is located on your server at /etc/php5/fpm/php.ini and with Apache it is /etc/php5/apache2/php.ini (depending on which version of php you are using). If you are using Cpanel you can change it by using WHM’s PHP editor by going to Home > Service Configuration > PHP Configuration Editor.

      Be sure to restart your server once the changes have been made.

  • Alex

    What about “Internal error”? What could be causing this?

    • Alex

      ok found the problem. The path to uploads folder was wrong under WP-Admin > Settings > Media. I changed it to the correct one and i dont see this error anymore.

      • Insite Advice

        I don’t see this setting??

  • litleist

    Hi, i still get Internal Error and Missing Meta Data even i did the define(‘WP_DEBUG’, true);
    define(‘SAVEQUERIES’, true);
    define(‘WP_DEBUG_LOG’, true);
    define(‘WP_DEBUG_DISPLAY’, true);
    error_reporting(E_ALL | E_STRICT); and define( ‘UPLOADS’, ‘wp-content/’.’files’ ); addition on config file. What can be the problem? Thanks.

  • Hey,

    i get the Code 0 on every PNG on the bulk optimation.

    “Alternatively, if setting the max_execution_time does not work, your firewall may be blocking the Optimus servers. In that case, try whitelisting the following IPs on your origin server.”

    What does this mean exactly? I have to add the IPs outgoing or in depth?

  • I got the Code 0 but after fiew days of search what was goingon finaly have added the “define(‘FS_METHOD’, ‘direct’);” line in the wp-config.php (without any space, with space wasn’t working) and all fixed up…

  • SharonMarks

    The plugin worked for 1200 images but for the last 300 I am getting an Internal Server error. Any ideas why this might be and how I can fix it. Thanks!

    • Do those images and all variations still exist in your filesystem?

  • Getting “Please select at least one item to perform this action on.” When trying to activate my licence.

    • You see this message when trying to click on the red “Activate Optimus HQ” text? Are you using the latest version of WordPress?

      • Figured it out. It was a plugin conflict. Thanks!