Supported Content Types

Supported File Formats

â„šī¸ JSON Format
JSON is currently supported for export only.
âš ī¸ Always Back Up Before Making Changes
The Importer directly modifies database records in bulk — these changes cannot be undone from within the plugin. Before running any update, make sure you have a full site backup. Here are several popular WordPress backup plugins:


Import Workflow

Step 1 — Select Content Type

Navigate to WP Import Export by RockStarLab → Import in the WordPress admin sidebar. Select the content type you want to import — for example, Pages.

Choose content type
Select the content type you want to import

Once you have selected the content type, click Next Step to proceed.

Next Step button
Click Next Step to continue to the next stage

Step 2 — Upload Import File

Select the file that contains the data you want to import. Click the upload area or drag and drop your CSV file onto it.

Choose import file
Select the CSV file with your import data

If needed, configure the delimiter used in your file — for example, a comma ,, semicolon ;, or tab. This should match the separator used in your CSV file.

Choose file delimiter
Select the delimiter that matches your CSV file format

Once the file is uploaded and the delimiter is set, click Next Step to proceed.


Step 3 — Preview Data

This screen displays a preview of the data parsed from your file. Only the first 5 rows of the import file are shown, so you can quickly verify that the data was read correctly before proceeding with the full import.

Data preview
Preview of the first 5 rows parsed from your import file

If the data looks correct, click Next Step to continue.


Step 4 — Field Mapping

On this step you map the columns from your CSV file to the corresponding WordPress content fields. Click Auto Map and the plugin will automatically match column names to the available fields.

Auto map fields
Click Auto Map to automatically match CSV columns to WordPress fields

Review the mapped fields and make any corrections if needed. To map a field manually, drag it from the left panel (CSV columns) and drop it onto the corresponding field in the right panel (WordPress fields).

Manual field mapping
Drag a CSV column from the left and drop it onto the target WordPress field on the right

At the bottom of the screen you will see a summary list of all currently mapped fields.

Mapped fields summary
The mapped fields summary at the bottom of the Field Mapping screen

Transformation Functions

With the PRO addon, you can assign a transformation function to any mapped field. The function will be applied to each value during import — for example, converting all post titles to uppercase before they are saved to WordPress.

To assign a function, click the wrench icon next to a field and select the desired functions from the list.

Open transformation functions
Click the wrench icon to open the function selector for a field
Select transformation function
Select one or more transformation functions to apply during import
Transformation function applied
The assigned function will be applied to the field value during import
💡 Create Your Own Transformation Functions (PRO)
The built-in function list not enough? You can write and save your own custom PHP transformation functions in the PRO Functions Library. Once saved, they will appear in the function selector here alongside the built-in ones.

When you are done mapping fields and assigning functions, click Next Step to proceed.


Step 5 — Import Options

This screen lets you configure additional options that control how the import behaves when processing your data.

Import options
Configure import behavior options before starting the import
OptionDescription
Check for Existing Items by Field Select which field to use when checking whether an item already exists in WordPress — for example, post_title, sku, or user_email. This prevents duplicate records from being created.
If Match Found Defines what to do when an existing item is found that matches the check field:
  • Update — overwrite the existing item with the imported data
  • Skip — leave the existing item unchanged and move on
  • Ignore — treat the record as new and import it without modifying the existing one
  • Create — always create a new item regardless of the match
If No Match Found Defines what to do when no existing item matches the check field:
  • Create — insert the record as a new item
  • Skip — do not import the record if no match is found
Batch Size The number of records processed per batch. Lowering this value can help avoid timeouts or memory issues on servers with limited resources.
Automatically Import Media Files When enabled, the plugin will automatically download and import all media files found in the content (images, attachments, etc.) directly into your WordPress Media Library during the import process.

Once you have configured the options, click Start Import to begin the import process. The plugin will process your records in batches and display real-time progress.


Step 6 — Import Results

Once the import is complete, you will see a results summary showing how many records were created, updated, skipped, and whether any errors occurred during the process.

Import results
The import results screen displayed after the process is complete
📚

Check our blog for more tutorials

Explore practical guides, workflow ideas, and step-by-step tutorials for importing, exporting, syncing, and managing WordPress content.

Visit the Blog →