Getting Started
Export/Import Media is built for safe WordPress media operations: simple migrations in Free, and reusable advanced workflows in Pro.
Initial Setup
- Install the free plugin from Plugins > Add New.
- Open Media > Export/Import to export or import media.
- Install and activate Pro when you need existing-media updates, background jobs, rollback, conversion, saved workflows, or automations.
Start with a small export/import test so you can confirm your CSV structure before running larger jobs.
Exporting to CSV
Generating a CSV of your library is the best way to audit your current SEO metadata or prepare a migration file.
Filter Options
- Date Range: Export only recently uploaded files.
- Media Type: Filter to only export Images, PDFs, or Videos.
- Attachment Context: Choose between all media or only those attached to specific posts.
The resulting file will contain columns for ID, Title, Alt Text, and the direct URL of the asset.
Importing from CSV
This is the primary way to bring new assets into your site or move them from a staging environment.
Safety First: The Preview
When you upload a CSV, the plugin doesn't start immediately. It parses the file and shows you a Visual Preview. This allows you to verify that your "Alt Text" column matches our internal "Alt Text" field.
Batching
WordPress can be slow when processing images. We break your import into small chunks (batches). If the process is interrupted, you can resume right where you left off.
Local Import Mode
A "Normal" import asks WordPress to download a file from a URL. But if you have 50,000 files, downloading them one-by-one is inefficient.
Local Import Mode is for when you have already moved the files to your server (via FTP, SSH, or CPanel). The plugin skips the download step and simply registers the files into the database. It is roughly 10x faster than a standard import.
Honor Relative Paths
WordPress usually organizes media by year and month (e.g., uploads/2024/05/img.jpg).
If you are migrating a site from 2019, your images are in uploads/2019/.... If you do a regular import, WordPress will move them all to the current month's folder, breaking your old post links.
By enabling Honor Relative Path, the plugin forces WordPress to respect the original folder structure defined in your CSV, keeping your site structure and SEO intact.
Updating Existing Media (Pro)
Pro lets you update media already in your library without re-uploading every file.
Typical use case
Export the library, improve alt text and titles in a spreadsheet, then re-import using an update workflow. The plugin matches the existing attachment and updates only the selected metadata fields.
Safer default behavior
Use selected-field updates so blank CSV cells do not accidentally erase existing values unless you intentionally choose a destructive workflow.
Remote CSV Sources (Pro)
Saved import workflows can use a remote CSV URL, such as a public spreadsheet export link, or a server-side CSV path for advanced use cases.
This is useful when the same file is updated regularly and you want WordPress to process it through a repeatable workflow instead of uploading the CSV manually every time.
Background Processing (Pro)
The Pro background queue is designed for larger runs that should not depend on an open browser tab.
You can start a workflow, let the server process the job, and later review the result in History with summaries and downloadable logs.
Match Strategies (Pro)
When updating existing media, the plugin needs to identify the right attachment. Depending on your CSV and migration scenario, you can match by:
- Attachment ID: most accurate when IDs are from the same site.
- Source URL: useful when the original URL is available.
- Filename: useful when IDs changed during a migration.
Use the most specific match strategy available to reduce accidental updates.
History & Automations (Pro)
Pro History gives you summaries, downloadable logs, restore-point information, conversion counts, rollback information, and export artifact re-downloads when available.
Optional automations are for repeatable scheduled workflows. Manual imports and exports can still be used normally without configuring automations.
Rollback & Restore Points (Pro)
When Pro runs supported real imports with an active license, it can create restore points before changes are applied.
Rollback actions are available from Pro History for supported changes such as new attachments, metadata updates, replace-file runs, and converted imports.
Image Conversion (Pro)
Pro can convert supported JPG/JPEG and PNG imports to WebP or AVIF when WordPress and the server image editor support the selected output format.
Safe fallback
If the server cannot write the selected format, unsupported files are skipped safely or imported normally depending on the workflow settings.
Troubleshooting
The process stopped halfway
In the free version, make sure the browser tab stays open and the computer does not go to sleep. For larger jobs, use Pro saved workflows and background processing.
My CSV is not being recognized
Check that the CSV has headers and at least one data row. Also confirm the separator and encoding, especially when exporting from spreadsheet apps.
I do not see rollback
Rollback appears only for supported Pro imports created with the version that stores restore points. It cannot retroactively restore old imports that were run before restore points existed.
Image conversion is unavailable
WebP and AVIF depend on WordPress and server image editor support. If the format is not supported by the hosting environment, the option may be disabled or skipped safely.