---
url: 'https://dxpr.com/hc/documentation/learn-dxpr-builder/migration/from-paragraphs'
title: 'Move pages from Paragraphs to DXPR Builder | DXPR'
author:
  name: docs-sync
  url: 'https://dxpr.com/users/docs-sync'
date: '2026-10-23T14:31:17+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: 'Move content from the Paragraphs module'
tags:
  - 'Move from another builder'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-23T14:31:17+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Move pages from Paragraphs to DXPR Builder'
      description: 'Move content from the Paragraphs module'
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-23T14:31:17+0000'
      dateModified: '2026-10-23T14:31:17+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/hc/documentation/learn-dxpr-builder/migration/from-paragraphs'
      articleSection: 'Move from another builder'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/hc/documentation/learn-dxpr-builder/migration/from-paragraphs'
      description: 'Move content from the Paragraphs module'
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: Home
            item: 'https://dxpr.com/'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: en
---
[Help Center](/hc)/[Documentation](/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Start here](/hc/documentation/learn-dxpr-builder/start-here) /[Move from another builder](/hc/documentation/learn-dxpr-builder/migration) # Move pages from Paragraphs to DXPR Builder.

Move content from the Paragraphs module

 Learn DXPR BuilderStart hereMove from another builder

   ## In this guide

 Related guides

- [From Layout Builder](/hc/documentation/learn-dxpr-builder/migration/from-layout-builder)
- [Element picker](/hc/documentation/learn-dxpr-builder/editing/element-picker)

You rebuild the paragraphs of each page as DXPR Builder elements, in a new field on the same content type. The paragraphs stay online until every page is done. Afterwards, editors design the page on the page itself instead of filling in paragraph forms. No tool converts paragraphs, but Drush can write prepared HTML into many pages at once.

## Before you start

- DXPR Builder is installed and your product key is saved, see [General settings](/hc/documentation/learn-dxpr-builder/admin/general-settings).
- You can manage the fields and the display of the content type.
- Every page of the content type counts as a content item once its display uses the DXPR Builder formatter. Check your limit on the **Content Items** tab.

## Set up

1. Go to **Structure** > **Content types**(`/admin/structure/types`) and click **Manage fields** for the content type.
2. Add a field: choose **Formatted text**, then **Long text**, for example "Page content".
3. Click **Manage display** and set the **Format** of the new field to **DXPR Builder**.
4. Leave the Paragraphs field where it is and click **Save**.

## Rebuild each page

1. Open the page. The empty DXPR Builder field shows next to the paragraphs.
2. Rebuild each paragraph with the matching element from the table below.
3. Copy the text of each paragraph into the new elements.
4. Click **Save** on the DXPR Builder toolbar.

| Paragraph type | DXPR Builder element |
|---|---|
| Text | **Text** |
| Image | **Image** |
| Text with image | **Row** with two columns: **Text** and **Image** |
| Accordion | **Collapse panel** on the **Layout** tab |
| Call to action | **Button** |
| Video | **Video** |
| Gallery | **Image carousel** |
| Webform | The webform block on the **Drupal Blocks** tab |
| Anything else | **HTML**, or a combination of elements |

## Rebuild many pages with Drush

DXPR Builder turns Bootstrap 5 HTML into elements you can drag and edit. If you can export the old content as HTML, write it into each page with Drush. Try it with `--dry-run` first, which shows the change without saving:

```bash
drush dxb:page:update 42 --markup=@/tmp/page-42.html --dry-run
drush dxb:page:update 42 --markup=@/tmp/page-42.html

```

The command finds the DXPR Builder field on the default display of the content type. It saves a new revision, so you can roll back.

## Finish the move

1. On **Manage display**, move the Paragraphs field to **Disabled** and click **Save**.
2. Check the rebuilt pages, also on a phone.
3. Delete the Paragraphs field on **Manage fields**only when you no longer need its content. Deleting it removes the paragraphs for good.

## What you see

Each page shows the content of the DXPR Builder field, and the paragraphs no longer appear. Editors with the **Edit with DXPR Builder** permission see the editing controls on the page. The **Content items** tab lists every page of the content type.

## If you don't see the editor

- **The page shows the old and the new content.**The Paragraphs field is still on the display. Move it to **Disabled** on **Manage display**.
- **Drush reports "No DXPR Builder field found".**The default display does not use the DXPR Builder formatter. Set the **Format** on **Manage display**of the default view mode.
- **Drush reports "Multiple DXPR Builder fields found".** The content type has more than one. Name the field, for example `--field=field_page_content`.
- **The field shows, but no editing controls.** Your account lacks the **Edit with DXPR Builder**permission, or your licence limits are reached. See [Licence and product key errors](/hc/documentation/learn-dxpr-builder/troubleshooting/licence-and-product-key).

## What's next?

- [From Layout Builder](/hc/documentation/learn-dxpr-builder/migration/from-layout-builder): the same move for Layout Builder pages
- [The element picker](/hc/documentation/learn-dxpr-builder/editing/element-picker): every element you can use