[Breaking change]: Nested Content (Umbraco.NestedContent) to be deprecated from version 11 and removed in version 14

[lassefredslund]

Description

The old Nested Content introduced in version 7 will not be implemented with the new backoffice that is currently expected to be introduced in version 14.

Note: Nested Content will not be removed from existing projects in Heartcore

Version

Umbraco 14

Previous behavior

Nested Content could be used to create elements in documents.

New behavior

Blocks can be used within Block List Editor and Block Grid Editor to create elements in lists and grids.

Type of breaking change

• [ ] Binary incompatible: Existing binaries may encounter a breaking change in behavior, such as failure to load/execute or different run-time behavior.
• [X] Source incompatible: Source code may encounter a breaking change in behavior when targeting the new runtime/component/SDK, such as compile errors or different run-time behavior.

Reason for change

With the new backoffice, we want to streamline both the developer- and editor experience while we invest our effort in property editors that we foresee usable in a long term.

Recommended action

Start using blocks with the Block List Editor or Block Grid Editor.

Affected APIs

N/A

[JoseMarcenaro]

Hi. Good to know this, and it makes sense. Is there any tool available to assist in the migration?

[KevinJump]

Hi. Good to know this, and it makes sense. Is there any tool available to assist in the migration?

Hi, Nothing official, but uSync.Migrations will convert Nested Content & Grid to Block List and Block Grid if you need it too.

[JoseMarcenaro]

Thanks @KevinJump ! Once again, uSync will come to the rescue... 🥇

[thomashdk]

Hi. Good to know this, and it makes sense. Is there any tool available to assist in the migration?

Hi, Nothing official, but uSync.Migrations will convert Nested Content & Grid to Block List and Block Grid if you need it too.

How does work with site with a lot of nodes ? : )

[bielu]

@thomashdk pretty well :)

[Shuchita]

Did Anyone Here successfully Upgraded from 13 to 14 version with nested content and grid to Block list and Block grid with migrations , If yes please let me know Steps

[bielu]

@Shuchita i would recommend using usync migration to move nested content, grid to block and block grid editors first :) and later update to v14. As than you remove one of big issues with v13-v14 upgrades :). Personally I didnt done yet v14 upgrade (and not planning anytime soon), but the path which i would took:

• Upgrade all editors with usync migrations
• adjust any code using xpath to use content finder/ query root (mntp) / custom code
• upgrade umbraco to latest v13
• upgrade umbraco to v14

[Shuchita]

Can you please suggest any particular steps for this -> (would recommend using usync migration to move nested content, grid to block and block grid editors first )

[bielu]

@Shuchita i mostly followed https://github.com/Jumoo/uSyncMigrations/blob/main/GETTING-STARTED.md and from code, but also i didnt done just migration v13->v13 but v7->v13 so yeah not best place to give advice with it, but it should be straigh forward by using already built-in migration plan :)

[Shuchita]

@bielu, Thank You for the help It has Updated the data type from nested content to block list but I have lost the data, any views on this ?

[bielu]

@Shuchita did you follow instruction and import content from migration as well, not just datatypes/content types?

[Shuchita]

yeah @bielu that works for the nested content but didn't worked for block grid I am getting an error for that ,please have a look

[bielu]

@Shuchita that erros is probably about usage of editor which dont have converter yet or are you using dtge? if so you need write own plan which use dtge to block grid migration instead :)

[Shuchita]

@bielu that issue was resolved, But have you any idea on how to migrate the Legacy Media Picker to Media Picker 3

[bielu]

@Shuchita same thing usync migrations, you can create plan but you need check aliases as MP had multiple versions of aliases through years :)

[Shuchita]

@bielu , can you Explain more about it , I didn't get you

[Shuchita]

I was Upgrading one more project , which was in Umbraco 9.5.0 I Have Upgraded it to Umbraco 13.5.1 Successfully and after that I have nested content in my project so I Migrated Nested content to Block List Using Usync.migrations and it Successfully migrated my content. After that I have tried to upgrade from Umbraco 13.5.1 to Umbraco 14.2.0(Latest) and getting below Error

Error
Database configuration failed

System.InvalidOperationException: The migration plan does not support migrating from state "{CC47C751-A81B-489A-A2BC-0240245DB687}".\r\n at Umbraco.Cms.Infrastructure.Migrations.MigrationPlan.ThrowOnUnknownInitialState(String state)\r\n at Umbraco.Cms.Infrastructure.Migrations.MigrationPlanExecutor.RunMigrationPlan(MigrationPlan plan, String fromState)\r\n at Umbraco.Cms.Infrastructure.Migrations.MigrationPlanExecutor.ExecutePlan(MigrationPlan plan, String fromState)\r\n at Umbraco.Cms.Infrastructure.Migrations.Upgrade.Upgrader.Execute(IMigrationPlanExecutor migrationPlanExecutor, ICoreScopeProvider scopeProvider, IKeyValueService keyValueService)\r\n at Umbraco.Cms.Infrastructure.Migrations.Install.DatabaseBuilder.UpgradeSchemaAndData(MigrationPlan plan)

I have also tried by upgrading it to 14.0.0 , 14.1.0 ,14.1.1 ,14.1.2 but None of these worked for me

Please Let me Know If anyone has idea about it

Thanks

[nlhiorth]

I was Upgrading one more project , which was in Umbraco 9.5.0 I Have Upgraded it to Umbraco 13.5.1 Successfully and after that I have nested content in my project so I Migrated Nested content to Block List Using Usync.migrations and it Successfully migrated my content. After that I have tried to upgrade from Umbraco 13.5.1 to Umbraco 14.2.0(Latest) and getting below Error

Error Database configuration failed

System.InvalidOperationException: The migration plan does not support migrating from state "{CC47C751-A81B-489A-A2BC-0240245DB687}".\r\n at Umbraco.Cms.Infrastructure.Migrations.MigrationPlan.ThrowOnUnknownInitialState(String state)\r\n at Umbraco.Cms.Infrastructure.Migrations.MigrationPlanExecutor.RunMigrationPlan(MigrationPlan plan, String fromState)\r\n at Umbraco.Cms.Infrastructure.Migrations.MigrationPlanExecutor.ExecutePlan(MigrationPlan plan, String fromState)\r\n at Umbraco.Cms.Infrastructure.Migrations.Upgrade.Upgrader.Execute(IMigrationPlanExecutor migrationPlanExecutor, ICoreScopeProvider scopeProvider, IKeyValueService keyValueService)\r\n at Umbraco.Cms.Infrastructure.Migrations.Install.DatabaseBuilder.UpgradeSchemaAndData(MigrationPlan plan)

I have also tried by upgrading it to 14.0.0 , 14.1.0 ,14.1.1 ,14.1.2 but None of these worked for me

Please Let me Know If anyone has idea about it

Thanks

There's a bug when upgrading from 13.5 to 14: https://our.umbraco.com/forum/using-umbraco-and-getting-started/114738-cant-upgrade-from-1351-to-1400 Tl;dr: Umbraco devs forgot to add the migration state in their code. You can either try the upgrade from 13 or 13.3, or changing the migration state in the database as described in that thread.

[Shuchita]

Okay @nlhiorth , Thank you for your help can you please tell me how can i migrate my media as well that it is in the Grid layout ?

[Shuchita]

Hi @bielu , can you please let me know how i can migrate my Images as well in the grid layout , the only problem i am getting now is just I am unable to get te Images in the migrated Block Grid ,Please Help

[bielu]

@Shuchita not sure i follow, as migration of grid to block grid should do it for you. I also dont have currently any examples of migrations to do it, I guess you will need do little try and repeat approach.

[Shuchita]

Thanks @bielu