--- title: "Converter" description: "Use the Bricks converter workflow to transform source markup or data into Bricks-compatible structures more safely." canonical: "https://academy.bricksbuilder.io/developer/guides/converter/" markdownUrl: "https://academy.bricksbuilder.io/developer/guides/converter.md" pageType: "article" section: "developer" category: "guides" lastmod: "2026-05-21T13:58:32.000Z" --- Bricks offers multiple so-called "Converter" options. The Converter is a built-in tool that scans your database for outdated Bricks data and automatically updates it to the latest valid syntax of the installed version. :::note The converter performs changes to the Bricks data in your database. So please perform a full-site backup before running the converter. ::: To run the Converter, go to "Bricks > Settings > General" and click the "Converter" button. Depending on your server and the size of your Bricks data, this process can take a minute or two. Please do not close or refresh the page until you see the green "THE END" success message: ![](/assets/bricks-1.4-converter-results-1024x324.png)
Converter results: Updated Page Settings & Global Custom CSS
## What is being converted? With the improved DOM structure and element ID & class names, Bricks replaced the old `bricks-element-` ID & class name prefix with a more succinct `brx-` prefix. Running the Converter goes over the following pieces of Bricks data and does an automated "Search & Replace" of those strings for you: - Bricks global settings - Bricks page settings - Bricks page data - Global elements - Bricks templates **You shouldn't have to run the Converter if you aren't using any custom CSS/JS.**