Skip to content

Releases: contentstack/migration-v2

New Release: AEM to Contentstack Connector Now Available (v1.1.2)

27 Nov 12:28
2dbb235

Choose a tag to compare

New Release: AEM to Contentstack Connector Now Available (v1.1.2)

🧭 Overview

This release introduces a new AEM to Contentstack connector, enabling migration of content and data from Adobe Experience Manager (AEM) to Contentstack. It also includes stability and performance improvements to existing modules in the migration framework.


✨ What’s New

🔌 AEM → Contentstack Connector

  • Adds support for migrating content from Adobe Experience Manager (AEM) to Contentstack
  • Supports key content structures based on the available AEM data samples

🛠 Existing Feature Enhancements

  • Performance optimizations in existing migration pipelines
  • Improved reliability during data processing
  • Minor bug fixes and code cleanup

⚠️ Limitations

Migration to an Existing Stack

  • Migration into an existing destination stack is not supported in this release
  • Only the "Create New Stack" approach is currently available
  • Support for existing stack migration is planned for Q1 next year

AEM Data Coverage

  • The connector is based on limited AEM data samples
  • Due to variations in AEM structures, some content types or configurations may not be supported

Component Support

  • Not all AEM components are supported in this version
  • Custom or unique components in AEM may not be migrated

Asset Migration Dependency

  • Assets must be extracted from the AEM DAM using the provided script
  • Without this step, asset migration cannot be performed

🧾 Impact

This release enables a more streamlined migration path from Adobe Experience Manager to Contentstack, reducing manual effort and improving migration efficiency for supported structures.


If you have issues or feature requests, please raise them via GitHub Issues.

Multi-Platform CMS Migration Support with Enhanced Logging

19 Aug 13:50
3c9dc78

Choose a tag to compare

📌 Summary

This release introduces Docker configuration for cross-platform CMS migrations and comprehensive logging capabilities for better migration visibility and traceability.

🧭 What's New

✨ Major Features

  • Docker Configuration Support - Seamlessly migrate data from multiple CMS platforms including:

  • Sitecore

  • Contentful

  • WordPress

  • Execution Logs Dashboard - New dedicated screen for:

  • Real-time migration progress monitoring

  • Issue identification and debugging

  • Complete traceability of migration steps

  • Audit Logs Interface - Comprehensive audit trail featuring:

  • User activity tracking (who, what, when)

  • Content-level action logging

  • Compliance and accountability reporting

🔧 Enhancements

  • Improved existing migration features
  • Better Windows OS compatibility through Docker

🧾 Impact

  • Cross-Platform Support: Windows users can now perform Sitecore data migrations seamlessly
  • Enhanced Visibility: Complete transparency into migration processes through execution logs
  • Compliance Ready: Full audit trail for all migration activities
  • Improved Debugging: Detailed logs help quickly identify and resolve migration issues

v1.0.1

13 Jun 17:54
eb97a5e

Choose a tag to compare

Key Changes

.talismanrc

  • Added new file checksums for:
    • upload-api/src/helper/index.ts
    • upload-api/package-lock.json
    • api/package-lock.json
  • Tightens secret scanning and integrity verification for updated files.

README.md

  • Removed CLI Setup Instructions:
    The section describing pnpm installation and npm run setup-repo was deleted.
    Documentation now focuses on available scripts and configuration.

api/package.json & api/package-lock.json

  • Dependency Updates:
    • Upgraded @contentstack/cli-utilities from ^1.11.1 to ^1.12.0
    • Indirect upgrades for sub-dependencies, including:
      • @contentstack/management to ~1.21.4/1.21.6
      • @contentstack/marketplace-sdk to ^1.2.8
      • @oclif/core to ^4.3.0
      • axios to ^1.9.0
      • dotenv to ^16.5.0
      • papaparse to ^5.5.3
      • Added husky (^9.1.7)
      • Multiple brace-expansion upgrades
  • Improves security, stability, and compatibility.

upload-api/package-lock.json

  • Dependency Upgrades:
    • Multiple upgrades for brace-expansion and related packages to address security advisories.

upload-api/src/helper/index.ts

  • Refactored Zip Extraction Logic:
    • Always prepends the main folder name to extracted files unless already present.
    • Skips writing files/directories that match the Mac OS X resource folder.
    • Cleans up logic for handling zip files, ensuring robust extraction for various structures.

Impact

  • Security: Improved dependency management and secret scanning.
  • Reliability: More robust zip extraction logic, especially for edge cases and Mac OS X files.
  • Maintainability: Codebase is cleaner, with clearer documentation and logic.

v1.0.0

10 Jun 09:19

Choose a tag to compare

Release v1.0.0

We are excited to announce the release of v1.0.0 for the contentstack/migration-v2 repository!


Summary of Notable Changes

Added

  • SECURITY.md: Added a security policy and contact instructions.
  • CODEOWNERS: Added security-admin as code owner for all files.
  • api/package-lock.json: Locked dependencies for the API package.

Changed

  • .talismanrc:
    • Now includes version information and additional file checksums, especially for various package-lock.json files across the project.
    • Expanded ignore configuration for security scan-related files.

Details by File

  • Security & Licensing

    • Added SECURITY.md with responsible disclosure policy and contact.
    • Project now has a top-level CODEOWNERS file specifying security-admin as the owner.
  • Source Control & Configuration

    • Expanded .gitignore to ignore .vscode, but now tracks more previously ignored files (e.g., *.zip and package-lock.json).
    • .talismanrc improvements to cover more files for secret scanning.
    • Removed .vscode workspace recommendations and settings to reduce editor-specific configuration in the repo.
  • Dependency Management

    • Added api/package-lock.json (and several other package-lock files, referenced in .talismanrc) for reproducible builds.

Impact

  • Security and compliance improvements: Clearer code ownership, license, and security policy.
  • Dependency and configuration management: Improved reproducibility and auditing.
  • Editor experience: Removed VSCode-specific settings/recommendations for a more editor-agnostic repo.

View the full diff for more details

What's Changed

Full Changelog: v1.0.0-beta...v1.0.0

v1.0.0-beta: Core Modules & CMS Connectors

13 May 14:32

Choose a tag to compare

📌 Version: v1.0.0-beta (Beta Release)

This release includes the foundational components of the migration platform with support for multiple CMSs and initial migration flows.

✅ Included Modules and Features

⚠️ Known Limitations (Beta)

  • Contentful Connector
  1. Not handle the use case of deletion of existing destination stack in runtime
  2. Content mapper module | existing stack | existing content type mapped | Modular blocks, taxonomy these fields can be matched with Single Line Textbox field
  3. Content Type Migration Limitations in Test Stacks
  4. When migrating content types in a test stack, the handling of attached references depends on your organization's reference limit:
  5. Organizations with a reference limit of 50: Full data migration is supported if a content type has more than 10 references.
  6. Organizations with a reference limit of 10: If a content type has more than 10 references, only the 'title' and 'URL' fields will be migrated.
  7. Issue: Data migration may encounter unforeseen problems if the Contentful data contains duplicate UIDs.
  • Sitecore Connector
  1. Runtime Deletion Not Handled
    The system does not handle the deletion of an existing destination stack during runtime.

  2. Content Type Migration Limitations in Test Stacks
    When migrating content types in a test stack, the behavior depends on your organization's reference limits:

    • Organizations with a reference limit of 50:
      Full data migration is supported even if a content type has more than 10 references.

    • Organizations with a reference limit of 10:
      If a content type has more than 10 references, only the 'title' and 'URL' fields will be migrated.

  • Wordpress Connector
  1. Not supporting WordPress dynamic content models

  2. Supports only the basic data migration process

  3. Does not handle the use case of deletion of existing destination stack at runtime

  4. Content Type Migration Limitations in Test Stacks
    4.1 When migrating content types in a test stack, the handling of attached references depends on your organization's reference limit:

    4.2 Organizations with a reference limit of 50:
    Full data migration is supported if a content type has more than 10 references.

    4.3 Organizations with a reference limit of 10:
    If a content type has more than 10 references, only the 'title' and 'URL' fields will be migrated.

What's Changed

Read more