Documentation

Everything you need to install, configure, and get the best performance from WPvivid plugins.

WPvivid Docs Site

Restore Failed

Jan 15, 2026 | Knowledge Base

A restoration failure can be a stressful experience. This guide helps you understand why common restoration errors appear and provides actionable solutions to help you successfully recover your site.

Issues During Restoration

Restoration errors often occur when the server lacks the resources required to decompress files or import large database tables. By adjusting advanced settings for WPvivid restoration engine, you can typically resolve these bottlenecks.

Restore failed, SQL file importing timeout

  • Cause
    The server is struggling to finalize the database import, usually due to memory constraints or database packet size limits during the final stages of the process.
  • Solution
    Increase the resources available for the task.
    In pro version, open Advanced Settings on restore page → Custom → Increase maximum PHP memory limit for a restore task to 1024MB or 2048MB (higher than the database size).
    In free version, go to WPvivid Settings → Advanced Settings → Increase PHP Memory Limit for restoration to 1024MB or 2048MB (higher than the database size). If possible, on the server side, also increase the max_allowed_packet setting in your MySQL/MariaDB configuration to 32MB or 64MB.

Restore Memory Limit in Pro Version

Restore stuck at 99%

  • Cause
    Similar to the timeout error, the process often hangs at the very end when merging temporary database tables into the live environment, hitting a resource ceiling.
  • Solution
    In pro version, open Advanced Settings on restore page → Custom → Increase maximum PHP memory limit for a restore task to 1024MB or 2048MB (higher than the database size).
    In free version, go to WPvivid Settings → Advanced Settings → Increase PHP Memory Limit for restoration to 1024MB or 2048MB (higher than the database size).

Restore Memory Limit in Pro Version

Failed to decode restore data file

  • Cause
    This usually points to environmental limits: insufficient disk space, disk I/O limits, or the PHP time limit being too low for the size of your website files.
  • Solution
    Ensure your web hosting account has free disk space equal to at least twice the size of your website. Additionally, check if your server has a very strict limit (e.g., 60 or 120 seconds) and increase the execution time to a larger value (e.g., 180, or 300 seconds) allow the process to finish.

Allowed memory size exhausted

  • Cause
    The PHP memory allocated to the script has been completely used up while trying to process the backup files.
  • Solution
    In pro version, open Advanced Settings on restore page → Custom → Increase maximum PHP memory limit for a restore task to 1024MB or 2048MB (higher than the database size).
    In free version, go to WPvivid Settings → Advanced Settings → Increase PHP Memory Limit for restoration to 1024MB or 2048MB (higher than the database size).

Restore Memory Limit in Pro Version

Error: WPVIVID_PCLZIP_ERR_BAD_FORMAT (-10):End of Central Dir Record signature

  • Cause
    The backup files are likely corrupted, often due to the source server running out of disk space during the initial backup process.
  • Solution
    Download the backup to your computer and try to unzip it manually:
    If it unzips successfully, upload the files via FTP to /wp-content/wpvividbackups on the target site → click Scan uploaded backups and try the restore again.
    If it fails to unzip, it suggests that the file is broken. We recommend you to free up space on the source site and create a new backup.

Scan Uploaded Backups in Pro Version

Error: WPVIVID_PCLZIP_ERR_NO_ERROR (0)

  • Cause
    This usually indicates an incomplete backup where some parts of the archive are missing.
  • Solution
    Ensure the source website has enough disk space (2x site size) in the web hosting account. Before creating a new backup, go to plugin settings and uncheck the option “Merge all backup files into 1 zip” to reduce the storage burden during the backup phase.

An exception has occurred: class: PDOException

  • Cause
    A MySQL service exception or a specific PDO interface issue on your web server preventing database access.
  • Solution
    In pro version, switch the Database Access Method to WPDB and attempt the restoration again.
    In free version, go to WPvivid Settings → Advanced Settings → switch the Database Access Method to WPDB and attempt the restoration again.

Database Access Method in Pro Version

Tip
For the highest success rate, it is always recommended to perform the restoration on a fresh WordPress installation on the target site before uploading and restoring your backup files.