Import & Export

Import & Export

4 min read Updated Jun 4, 2026

Bulk import and export packages in WordPress Download Manager. Access from Downloads > Import & Export in your WordPress admin.

Overview

The Import & Export feature allows you to:

  • Migrate packages between WordPress sites
  • Bulk create packages from CSV files
  • Import files from server directories
  • Export packages for backup
  • Share package configurations

Export Packages

Export Options

FormatBest For
CSVSpreadsheet editing, bulk updates
JSONFull data preservation, API use
XMLWordPress import compatibility

What Gets Exported

DataCSVJSONXML
TitleYesYesYes
Files & URLsYesYesYes
Categories & TagsYesYesYes
SettingsPartialFullFull
Meta DataPartialFullFull
ImagesURL onlyURL onlyURL only
StatisticsNoYesYes

How to Export

  • Go to Downloads > Import & Export
  • Choose export format
  • Click Create Export File button
  • Download the file

Batch Export

For large numbers of packages:

  • Export runs in batches
  • Progress bar shows status
  • File downloads when complete
  • Large exports may take time

Import from CSV

CSV Format

Required columns:

ColumnDescriptionExample
titlePackage titleMy Download

Optional columns:

ColumnDescriptionExample
descriptionPackage descriptionFull description…
post_statusPublish statuspublish, draft
url_slugURL permalinkmy-download
filesAttached files (pipe-separated)file1.zip, file2.pdf
file_titlesFile display namesFile One, File Two
categoryCategory namesCategory1,Category2
tagsTag namesTag1,Tag2,Tag3
accessAllowed rolesadministrator,editor
versionPackage version1.0.0
templateLink templatedefault
page_templatePage templatedefault
password_lockEnable password0 or 1
passwordLock passwordmypassword
email_lockEnable email lock0 or 1
base_priceProduct price29.99
iconIcon URLhttps://…

Sample CSV

title,description,files,category,access,version
"My First Package","A great download","/uploads/file1.zip","Software","subscriber",1.0.0
"Another Package","Description here","/uploads/file2.pdf|/uploads/bonus.zip","Documents","all",2.0.0

Import Steps

  • Prepare your CSV file
  • Go to Downloads > Import & Export
  • Click the Select CSV File tab
  • Select  and upload your file
  • Review import results

Column Mapping

If your CSV uses different column names:

  • After upload, the mapping screen appears
  • Match your columns to WPDM fields
  • Skip columns you don’t want to import
  • Save mapping for future imports

Import Options

OptionDescriptionDefault
Update ExistingUpdate if title matchesDisabled
Create CategoriesAuto-create missing categoriesEnabled
Create TagsAuto-create missing tagsEnabled
Set StatusOverride status for allUse CSV value
AuthorAssign all to authorCurrent user

Batch Import

Large imports process in batches:

SettingDescriptionDefault
Batch SizeRows per batch10
DelaySeconds between batches0

Progress shows:

  • Current row
  • Success count
  • Error count
  • Time elapsed

Import from Directory

Directory Import

Import files directly from a server directory:

  • Go to Downloads > Import & Export
  • Select directory from the Select Directory list
  • Browse or enter directory path
  • Select files to import
  • Configure import options
  • Click Import Selected Files

File Browser

The file browser shows:

ColumnDescription
FilenameFile name
SizeFile size
TypeFile extension
ModifiedLast modified date

Import Options

OptionDescription
Create Package Per FileEach file = one package
Group FilesMultiple files = one package
Use Filename as TitleFile name becomes title
Move vs CopyMove file or copy it
Target DirectoryWhere to store files

Supported Locations

LocationPath
Uploads/wp-content/uploads/
WPDM Files/wp-content/uploads/wpdm-files/
CustomAny accessible directory

Import from JSON/XML

JSON Import

  • Go to Import tab
  • Select JSON file
  • Review package data
  • Click “Import All” or select specific packages
  • Confirm import

XML Import

  • Go to Import tab
  • Select XML file
  • WordPress-compatible XML supported
  • Review and import

Video Tutorial

Handling Errors

Common Import Errors

ErrorCauseSolution
File not foundInvalid file pathCheck file exists
Invalid CSVMalformed CSVCheck formatting
Missing titleNo title columnAdd title column
Permission deniedFile not readableCheck permissions
Memory limitFile too largeIncrease PHP memory

Error Log

After import, review the error log:

  • Check error log file
  • See row-by-row issues
  • Download error report
  • Fix issues and re-import

Rollback

If import goes wrong:

  • Note imported package IDs
  • Go to Downloads > All Downloads
  • Filter by import date
  • Bulk delete if needed

Migration Between Sites

Full Migration

  • Source site: Export all packages (JSON recommended)
  • Export media: Note all file URLs
  • Target site: Import JSON file
  • Transfer files: Upload files to target
  • Update URLs: Fix file paths if needed

Partial Migration

  • Export specific categories
  • Export specific packages
  • Import to target
  • Reassign categories if needed

Post-Migration Checklist

TaskDescription
Verify countsSame number imported
Check filesFiles accessible
Test downloadsDownloads work
Check categoriesProperly assigned
Review settingsPackage settings correct

Automation

WP-CLI Commands

# Export packages
wp wpdm export --format=csv --output=/path/to/export.csv

# Import from CSV
wp wpdm import /path/to/import.csv --create-categories

# Import from directory
wp wpdm import-dir /path/to/files --create-packages

Scheduled Exports

Set up automatic exports:

  • Go to Cron Jobs Settings
  • Create new job
  • Hook: wpdm_scheduled_export
  • Set schedule
  • Configure export path

Tips

  • Always backup before bulk imports
  • Test with small CSV first
  • Use JSON for complete data preservation
  • Check file paths in CSV are correct
  • Match column names exactly for smooth import
  • Review import log for any errors
  • Keep export files for disaster recovery

Related Documentation