--- url: 'https://dxpr.com/hc/documentation/learn-dxpr-builder/getting-started/updating' title: 'Update 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: 'Keep the module current with Composer and `drush updatedb`' tags: - 'Install and update' 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: 'Update DXPR Builder' description: 'Keep the module current with Composer and `drush updatedb`' 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/getting-started/updating' articleSection: 'Install and update' - '@type': WebPage '@id': 'https://dxpr.com/hc/documentation/learn-dxpr-builder/getting-started/updating' description: 'Keep the module current with Composer and `drush updatedb`' 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) /[Install and update](/hc/documentation/learn-dxpr-builder/start-here/install) # Update DXPR Builder. Keep the module current with Composer and `drush updatedb` Learn DXPR BuilderStart hereInstall and update ## In this guide Related guides - [Backup and restore](/hc/documentation/learn-dxpr-builder/advanced/backup-restore) - [Changelog](/hc/documentation/learn-dxpr-builder/getting-started/changelog) - [Problems after updating](/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating) Update DXPR Builder to get bug fixes, new features and security fixes. You update the code with Composer, then let Drupal convert settings and content with `drush updatedb`. Use this page for updates within the 3.x series. Coming from 1.x or 2.x? Follow [Migrating from DXPR Builder 1.x or 2.x](/hc/documentation/learn-dxpr-builder/getting-started/migration-1x-to-3x) instead. ## Before you start - Back up the database: ```bash drush sql:dump > backup-$(date +%Y%m%d).sql ``` - Read the [Changelog](/hc/documentation/learn-dxpr-builder/getting-started/changelog) and the [GitHub releases page](https://github.com/dxpr/dxpr_builder/releases)for changes that need action, such as the move to [Font Awesome 7](/hc/documentation/learn-dxpr-builder/getting-started/font-awesome-7). - Try the update on a staging copy of the site first. ## Update the module 1. Update the code: ```bash composer update drupal/dxpr_builder --with-dependencies ``` 2. Run the database updates. You can also visit `/update.php` instead: ```bash drush updatedb ``` Some updates convert every DXPR Builder field value in batches. On large sites they take minutes, not seconds. 3. Rebuild the caches, so browsers receive the new style sheets and scripts: ```bash drush cache:rebuild ``` ## What you see Pages with DXPR Builder content look as they did before. Hover one as an editor and the control bars appear; make a small change and click **Save** to check that saving works. **General Settings** still shows your product key under **License**. Then open **Reports** > **Status report** (`/admin/reports/status`). Next to **DXPR Builder content migrations** it says **All migrations completed**. ## If you don't see the new version - **The editor still behaves like the old version.** The browser keeps the old editor files. Reload with Ctrl+Shift+R, or Cmd+Shift+R on a Mac. - **The status report says "Some DXPR Builder content migrations have not been completed".** Content still waits for conversion. Open **View migration status** in that message, or go to `/admin/dxpr_studio/dxpr_builder/migration-status`, and click **Run all pending migrations**. - **Pages look wrong or elements are missing.** See [Problems after updating](/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating) for the causes and fixes. If the update breaks the site and nothing above helps, roll back: 1. Restore your database backup: ```bash drush sql:cli < backup-20260901.sql ``` 2. Restore the version you were on, for example 3.0.0-beta19: ```bash composer require 'drupal/dxpr_builder:3.0.0-beta19' ``` 3. Rebuild the caches: ```bash drush cache:rebuild ``` ## What's next? - [Backup and restore](/hc/documentation/learn-dxpr-builder/advanced/backup-restore): a backup routine for builder content before major updates. - [Changelog](/hc/documentation/learn-dxpr-builder/getting-started/changelog): what changes in each release. - [Problems after updating](/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating): fixes for the most common update issues.