You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Integrate React 

Make sure that you place all JS modules in the bundle’s public folder. If the bundle does not exist, create one following the instruction in the Create a Bundle topic.

Keep in mind that if you create a new bundle or fail to create symlinks when installing the application, you need to run the following command bin/console assets:install --symlink. For more information, please see OroAssetBundle documentation.

The example below illustrates creating a simple component, such as the one shown in the screenshot.

React demo
  1. Install dependencies. Navigate to the root folder and modify the composer.json (or dev.json if you use the developer mode) file with the code below. After updating the composer config file, execute the composer install command.

    "extra": {
        "npm": {
            "prop-types": "^15.7.2",
            "react": "^17.0.2",
            "react-dom": "^17.0.2",


    To learn how to add dependencies to Composer, see Managing NPM dependencies with Composer.

  2. Install a react preset for Babel using the npm install @babel/preset-react --save-dev command.


    Since React uses JSX syntax, you must build with Babel. You can change the command parameters for building in package.json in the project. Use "watch": "npm run webpack -- -w --progress --env withBabel" and "build": "npm run webpack -- --mode=production --env withBabel" commands with additional withBabel option.

  3. Open your webpack.config.js and replace the existing code with the code below:

    const OroConfig = require('@oroinc/oro-webpack-config-builder');
            'presets': [...OroConfig._babelConfig.presets, '@babel/preset-react']
    module.exports = OroConfig.getWebpackConfig();
  4. Create a React component and copy the code below:

    import React, { Component } from 'react';
    import PropTypes from 'prop-types';
    class App extends Component {
        constructor(props) {
            this.state = {
                title: props.initialTitle,
                content: props.initialContent,
                editMode: false
            this.enterEditMode = this.enterEditMode.bind(this);
            this.exitEditMode = this.exitEditMode.bind(this);
            this.handleChangeTitle = this.handleChangeTitle.bind(this);
            this.handleChangeContent = this.handleChangeContent.bind(this);
        enterEditMode(event) {
                editMode: true
        exitEditMode(event) {
                editMode: false
        handleChangeTitle(event) {
        handleChangeContent(event) {
        render() {
            const {title, content, editMode} = this.state;
            let children;
            if (editMode) {
                children = <form className="grid">
                    <div className="grid__row">
                        <label htmlFor="name">Title</label>
                        <input type="text" id="name" className="input" name="title" onChange={this.handleChangeTitle} defaultValue={title}/>
                    <div className="grid__row">
                        <label htmlFor="content">Content</label>
                        <textarea className="input" id="content" name="content" onChange={this.handleChangeContent} defaultValue={content}></textarea>
                    <div className="grid__row">
                        <button type="submit" className="btn btn-primary" onClick={this.exitEditMode}>Update</button>
            } else {
                children = <>
                    <button className="btn edit-mode" onClick={this.enterEditMode}>Edit</button>
            return (
    App.propTypes = {
        initialTitle: PropTypes.string.isRequired,
        initialContent: PropTypes.string.isRequired
    export default App;


    In all code examples, the bundle’s name is set to AcmeBundle. When copying, remember to correct the name of the bundle in the paths according to your bundle.

  5. Add page component to the dynamic-imports: paths. Since React is not the base framework for Oro, enable Page Component to start the Vue application, which will ensure proper integration into the Oro application lifecycle. Create a file and insert the code below:

        - oroui/js/app/modules/react-module
            - oroui/js/app/components/react-app-component
            - acmereactapp/js/react-app/App
  6. To build the application after changes, run the npm run build command. To rebuild the application automatically, run the npm run watch command.

  7. Once the page component with Vue instance is created, declare it in the template of the required page. Copy and paste the code below:

    {% block _react_app_block_widget %}
        {% set attr = layout_attr_defaults(attr, {
            'data-page-component-react-app': {
                reactApp: 'acmereactapp/js/react-app/App',
                initialTitle: 'React demo',
                initialContent: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.'
        }) %}
        <div {{ block('block_attributes') }}>
            {{ block_widget(block) }}
    {% endblock %}
  8. Register your new widget and append it to the page container in the layout. For this, create a file. For more on the layout update, see the Layout topic.

            - '@setBlockTheme':
                  themes: 'layout.html.twig'
            - '@add':
                  id: react_app_block
                  parentId: page_container
                  prepend: true
                  blockType: block