BX Import/Export

Purpose of BX Import/Export

The BX Import/Export Suite helps you analyze shop data, export it, import it into other shops, and migrate image files between systems.

Typical use cases:

• Migrating a shop to a new server
• Data synchronization between test, staging, and live shops
• Partial export of specific data areas (for example, categories only)
• Validated data import with conflict handling

Access in Admin

Open it in the admin area via:

• Admin -> Utilities -> BX Import/Export

The suite is divided into tabs. Each tab has a clear purpose.

Tab: Information

The Information tab is the starting point of the suite.

You will find:

• A feature overview of the entire suite
• Quick-start notes for the typical workflow
• Direct jump buttons to Analysis and Emoji demo
• Important notes about backups, testing, and migration

What it is used for:

• Fast onboarding for new users
• Orientation on where to find each function
• A reminder of safe procedures before import/export

Tab: Analysis

In the Analysis tab, the shop database structure is checked.

You will find:

• Start button for database analysis
• Record counts (for example, categories, products, manufacturers)
• Structure details (for example, category hierarchy)
• Export readiness and recommendations
• Optional debug mode with extended system details

What it is used for:

• Understanding the current state before export/import
• Detecting data quality issues early
• Technical verification that an export is meaningful and complete

Tab: Export

In the Export tab, you create export files (JSON or ZIP).

You will find:

• Export type selection:
  • Manufacturers only
  • Categories only
  • Categories + products
  • Full export
  • Category branch (with tree-based category selection)
• Optional ZIP compression
• Notes about separating data export and image migration
• Start button to generate the export file

What it is used for:

• Targeted data output depending on migration scenario
• Reduced data volume through partial exports
• Transferable export packages for import into other systems

Tab: Import

In the Import tab, you import export files into the shop.

You will find:

• Import source selection:
  • Local file upload
  • File from the /import/ directory
• File validation before the actual import
• Conflict analysis (existing records, dependencies)
• Conflict strategies during import, for example:
  • Skip existing records
  • Overwrite existing records
• Import logs (log files), including view and delete

What it is used for:

• Safe and controlled data import
• Transparency about conflicts before execution
• Traceability through logs and import statistics

Tab: Files

In the Files tab, you manage already generated export files.

You will find:

• File list of all export files in the export directory
• File type (JSON/ZIP), file size, date
• Download action per file
• Delete action per file
• Cleanup of old files
• Short metadata info per file (for example export type, record counts)

What it is used for:

• Central storage control for all exports
• Quick download for handover or archiving
• Cleaning up old files to optimize storage and overview

Tab: Migration

The Migration tab is intended for image migration and file transfer.

You will find:

• Security and protocol notes (FTP/FTPS)
• Source selection:
  • FTP/FTPS source
  • Localhost source
• Target server configuration (FTP/FTPS)
• Connection test for source and target
• Image scope selection:
  • Categories
  • Manufacturers
  • Products
  • All
• Option "Overwrite existing files"
• Start image migration with progress indicator
• Additional function: upload an export file to the target server (/import/)

What it is used for:

• Transferring image files between shops/servers
• Combining data migration (export/import) and file migration (images)
• Secure transfer with FTPS

Tab: Emoji

The Emoji tab is an integrated demo and reference page for UI icons.

You will find:

• Debug display for UTF-8/emoji rendering
• Code examples for EmojiHelper
• Best-practice notes for consistent UI text
• Catalog of available emoji keys

What it is used for:

• Consistent icon language in the suite
• Quick reference for development and UI maintenance
• Diagnostics for rendering issues

Recommended Standard Workflow

1. Information - read and understand the workflow
2. Analysis - check current data state
3. Export - create an export and choose the right export type
4. Files - download and verify the file
5. Import - import in the target system (validate and set conflict strategy)
6. Migration - run image file migration