Shopping cart

Magento 2 create CMS page programmatically

Creating CMS page programmatically in Magento 2 is also a crucial method you need to learn. As soon as creating CMS page successfully, you will have full control of the management of the content on the page. There, you can edit or update or delete any data as need. With CMS page, it is flexible to intervene into the change of the content. In previous post, we talk about Create a CMS page in Admin, you also can follow the post to create a sample CMS page in backend.

In this topic, you can know how to insert CMS page programmatically into Magento 2 setup script through specific steps:

Overview of creating CMS Page programmatically

Step 1: Create UpgradeData.php file

Generate Setup/UpgradeData.php file in your module.

Step 2: Insert UpgradeData class

Use UpgradeData class as the below, then add required model with dependency injection and a code script to create a new CMS page.

namespace Vendor\Module\Setup;
use Magento\Framework\Setup\UpgradeDataInterface;
use Magento\Framework\Setup\ModuleContextInterface;
use Magento\Framework\Setup\ModuleDataSetupInterface;
 * @codeCoverageIgnore
class UpgradeData implements UpgradeDataInterface
     * @var \Magento\Cms\Model\PageFactory
    protected $_pageFactory;
     * Construct
     * @param \Magento\Cms\Model\PageFactory $pageFactory
    public function __construct(
        \Magento\Cms\Model\PageFactory $pageFactory
    ) {
        $this->_pageFactory = $pageFactory;
     * @param ModuleDataSetupInterface $setup
     * @param ModuleContextInterface $context
    public function upgrade(ModuleDataSetupInterface $setup, ModuleContextInterface $context)
        if (version_compare($context->getVersion(), '1.1') < 0) {
            $page = $this->_pageFactory->create();
            $page->setTitle('Example CMS page')
                ->setContent('Lorem ipsum dolor sit amet, consectetur adipiscing elit.')

Step 3: Setup the module version

Open etc/module.xml file, you need to set your module version in setup_version attribute that should be 1.1

Step 4: Run the upgrade script

Finally, run the following database upgrade script, then you will complete the creating new CMS page on your Magento 2 storefront.

bin/magento setup:upgrade

That’s all steps that allow you to create a new CMS page programmatically in Magento 2. Thank you so much for the watching!

Enjoyed the tutorial? Spread it to your friends!


Sam Thomas
Sam Thomas
CEO and Founder of Mageplaza. Pursueing a simple and healthy lifestyle. A friend, a husband and a dad of two children, a trainer and a wanna-be influencer. He is a big fan of sports and travel, also.

Comments for Magento 2 create CMS page programmatically

Please leave comments if you have any questions, feedbacks.

Module Development

We recommend:

People also searched for

  • magento 2 CMS pages programmatically
  • magento 2 create cms page programmatically
  • create page programmatically magento 2
  • magento 2 update cms page programmatically
  • magento 2 create static block programmatically
  • 2.1.x, 2.2.x, 2.3.x