Upgrading from 1x to 2x

A number of APIs have changed in the 2x version (see layout_paragraphs.api.php). Additionally, the "Disabled Items" feature from 1x has been removed in favor of the "Published" field. See #3228597: Upgrade path for "Disabled Items" feature from V1 for more info, and read step-by-step instructions below on how to prepare your website for this change.

Upgrading to 2x

First, make a backup of your site. Download the 2x version (preferably, use Composer: composer require drupal/layout_paragraphs:^2), run update.php, and clear the cache. Check your paragraph types, content types, and public-facing pages using Layout Paragraphs to confirm everything is working as expected. Notice any issues? Restore from your backup and consider opening an issue on the Layout Paragraphs issue page.

Moving from Disabled Items to Unpublished

The "Disabled Items" feature has been removed in the 2x version. While upgrading to Layout Paragraphs 2x, any paragraphs previously left under "Disabled Items" will be automatically unpublished. They won't show up in the front-end for site visitors (unless they have the "View unpublished content" permission), but they will still be available to admin users in the Layout Paragraphs Builder interface. In order to change the published status of paragraphs, the “Published” field will need to be enabled for each affected paragraph type.

Steps to enable the Published field for Paragraph Types:

• Navigate to Admin > Structure > Paragraph types.
• For each Paragraph type you wish to be able to publish / unpublish Paragraphs, click “Manage form display”.
• Move the “Published” field out of “Disabled” and place it wherever you wish in the order of fields.