[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.
• 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