Migrate K2 Pro

Complete K2 to Joomla Migration
Migrate all your K2 content — items, categories, tags, extra fields, and images — into native Joomla articles with a single click. No manual data entry, no SQL exports, no third-party tools required.

Original Data Untouched
The migration copies K2 data into Joomla without modifying or deleting anything in your K2 tables. Your original content remains safe and intact throughout the entire process.

Upgrade-Ready Method
Uses Joomla's method="upgrade" installer so you can update the component without losing settings or progress. Re-install safely at any time.

AJAX-Powered Batch Processing
Items are migrated in small batches via AJAX so the browser never times out — even with 10,000+ articles. Each batch runs server-side and reports back instantly.

Visual Progress Indicator
A live progress bar shows exactly how many items have been processed (e.g. 4,521 / 10,000 — 45%). Phase indicators highlight which step is currently running: categories, fields, tags, or items.

Elapsed Timer & Auto-Retry
An elapsed-time counter keeps you informed. If a batch fails due to a network hiccup, the system automatically retries up to 3 times before pausing with a clear error message and a Retry button.

K2 Items → Joomla Articles
Migrates title, alias, introtext, fulltext, meta description, meta keywords, author, created/modified dates, publish state, featured flag, ordering, hits, and language. Intelligently splits K2's combined text into Joomla's intro and full text fields using the readmore tag.

K2 Categories → Joomla Categories
Preserves the full parent-child hierarchy with proper nesting. Handles aliases, descriptions, publish state, and access levels. Idempotent — re-running won't create duplicates; existing categories are detected and reused automatically.

K2 Tags → Joomla Tags
All K2 tags are migrated to native Joomla tags with correct tag-to-article associations preserved via the content tag map.

K2 Extra Fields → Joomla Custom Fields
Field groups and individual fields are migrated with their types, labels, and configuration. Field values for each article are mapped and inserted into Joomla's native custom fields system. Media URLs inside field values are automatically rewritten.

Image Migration & Path Rewriting
K2 item images (intro and fulltext) are copied to a configurable Joomla-side folder. All image paths in article content and field values are rewritten from K2's media/k2/ structure to the new location.

Image Captions & Credits
K2's image_caption and image_credits metadata are mapped into Joomla's image_intro_alt, image_intro_caption, image_fulltext_alt, and image_fulltext_caption JSON fields — preserving SEO-relevant alt text.

Automatic Redirect Creation
For every migrated article, the component generates 301 redirect entries in Joomla's com_redirect, mapping old K2 URLs (both ID-based and alias-based patterns) to the new Joomla article URLs.

Zero SEO Loss
Search engines seamlessly follow the 301 redirects from your old K2 URLs to the new Joomla content. Existing backlinks, bookmarks, and indexed pages continue to work without 404 errors.

Rollback-Safe
All redirect entries created by MigrateK2 Pro are tagged with a comment identifier, so they are cleanly removed during a rollback without affecting your other redirect rules.

Download Without Migrating
Export raw K2 data directly from your database without running any migration. Perfect for archiving, analysis, or importing into external systems like WordPress or a spreadsheet.

Three Export Formats
Choose CSV (one ZIP file with a CSV per table), JSON (single structured file), or SQL (INSERT statements ready to import). Each format is generated on the fly with proper encoding and headers.

Selective Table Export
Pick exactly which K2 tables to include: items, categories, tags, extra fields, comments, and attachments. Check individual tables or use Select All for a complete dump.

Complete Data Removal
The Reset function deletes all migrated articles, categories, tags, custom fields, field groups, and URL redirects from Joomla — returning your site to its pre-migration state. Progress is cleared so you can start fresh.

Detailed Deletion Report
After a reset, you see exactly what was removed: "Removed: 16 articles, 4 categories, 7 tags, 6 custom fields, 32 redirects." No guessing whether the cleanup was complete.

Orphan Detection
The rollback engine goes beyond mapped records. It also detects and removes orphan fields (with k2_ prefix) and empty field groups left behind by partial or older migrations — ensuring a truly clean slate.

Persistent Log Table
Every migration action is recorded in a dedicated database table with timestamp, severity level (info, success, warning, error), phase, and a detailed message. The log survives page reloads and browser closes.

Filterable Log View
A clean admin page displays all log entries in a sortable table with color-coded severity badges. Quickly spot errors or warnings after a large migration run.

One-Click Clear
Clear all log entries with a single button when you no longer need the history. The log is also automatically cleared during a rollback to keep things tidy.

System Checks
The dashboard verifies K2 is installed, counts items and categories, and checks that media folders exist and are writable — all before you click anything.

Content Preview Counters
See exactly what will be migrated: items, categories, tags, fields, comments, and attachments displayed as clear counter badges. Know the scope of your migration upfront.

Quick Export Buttons
One-click CSV, JSON, or SQL export buttons right on the dashboard for fast data downloads without navigating to the migration page.

Image Base Path
Configure where migrated images are stored (default: images/k2-migrated). Paths are validated during pre-flight checks to ensure the folder exists and is writable.

Skip Trashed Content
Toggle whether trashed K2 items and categories are included or excluded from migration. Enabled by default so you only migrate live content.

Fallback Author
Set a fallback Joomla user ID for articles whose K2 author no longer exists in the system. Prevents orphaned content with no assigned author.

Duplicate Prevention
Categories are checked by alias and parent before creation — if a match already exists, it is reused instead of duplicated. Re-running the migration after a partial failure picks up exactly where it left off.

Progress Tracking
Migration state (current phase, item offset, completion flag) is stored in a dedicated progress table. Close your browser mid-migration and resume later without data loss or duplication.

Mapping Table
Every K2-to-Joomla ID relationship is recorded in a mapping table. This powers accurate field value assignment, tag associations, rollback, and duplicate detection across all entity types.

Two-Card Layout
The migration page presents two clear options side by side: "Migrate into Joomla" and "Download K2 Data." Users immediately understand what the component does without reading documentation.

Phase-by-Phase Steps
During migration, numbered step indicators show which phase is active (categories → fields → tags → items) with color-coded states: pending, active, done, and error.

Consistent Button Design
All actions use a unified button system with icons, clear labels, and appropriate colors (primary for actions, danger for destructive operations, outline for navigation). Backup warnings are prominently displayed before any migration starts.

Prominent Pre-Migration Warning
A clearly visible yellow warning banner appears on both the dashboard and migration pages, urging users to create a full backup using Akeeba Backup or their hosting panel before proceeding.

Confirmation Dialog
Clicking "Start Migration" triggers a JavaScript confirmation dialog that explicitly asks: "Have you created a backup?" — adding an extra layer of protection against accidental data changes.

Reset Confirmation
The reset/rollback action also requires explicit confirmation, clearly stating that all migrated content will be permanently deleted. No accidental data loss.

One ZIP, One Click
Install via Extensions → Manage → Install → Upload Package File. The component sets up its database tables, admin menu entry, language files, and configuration automatically. No manual SQL imports or file uploads needed.

Clean Uninstall
Removing the component through Joomla's extension manager drops all MigrateK2 tables (progress, mapping, log) and removes all files cleanly. Your Joomla content and K2 data are not affected.

Joomla 3.x Compatible
Built for Joomla 3.10+ using JModelLegacy, JControllerLegacy, and JViewLegacy patterns. Follows Joomla coding standards with proper token checks, database abstraction, and language string support throughout.