Set up a cms page for Magento

Set up a cms page for Magento

August 23, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Set up a cms page for Magento

Solving the Magento CMS Page Setup Mystery

Setting up a CMS page as your Magento home page should be a straightforward process, but it’s common to run into frustrating 404 errors when you’re just getting started. Let me walk you through the basic steps to set this up correctly for your installation at www.mymagentoinstall.com.

Step 1: Create Your CMS Page

First, log in to your Magento admin panel and navigate to Content > Pages under the CMS menu. Click on Add New Page.

Add New Page

In the Identifiers section:

  • Title: Give your page a title, like “Home”
  • URL Key: Leave this blank for now, as it will cause issues later
  • Is Active: Set to Yes

In the Content section:

  • Content: Write or paste in the content you want on your home page. You can use the WYSIWYG editor for formatting.

CMS Page Content

Click Save and Preview to ensure everything looks correct.

Step 2: Set Your Home Page

Next, we need to tell Magento which CMS page should be our home page. Go to System > Configuration in the top menu.

System Configuration

In the left sidebar under General, click on Default Pages.

Default Pages

Find the field for CMS Home Page and select your page from the dropdown menu. Make sure it’s set to Yes in the Is Active column.

Step 3: Fix the URL Key Issue

If you’ve followed these steps exactly, you should now see your home page when you navigate to www.mymagentoinstall.com. However, if you’re still getting a 404 error, it’s likely because of the empty URL Key field.

To fix this:

  1. Go back to Content > Pages.
  2. Click on your home page and look for the URL Rewrite section near the bottom.
  3. If there are no rewrites listed, click on Add URL Rewrite.
  4. In the Request Path field, enter the desired URL key for your home page (e.g., “home”).
  5. Leave everything else as is and click Save.

URL Rewrite

Step 4: Flush Cache

After making any changes in Magento, always remember to flush the cache to ensure your updates take effect immediately. You can do this by going to System > Cache Management and clicking on Flush Cache Storage.

Conclusion

Setting up a CMS page as your home page in Magento is actually quite simple when you know the right steps. Remember that leaving the URL Key field blank will cause issues, so always ensure it’s populated with an appropriate key.

If you’re still having trouble, feel free to reach out for more assistance on our Magento support forums or contact us directly at info@laravelcompany.com. We’re here to help!

Happy Magento development!

Admin Configuration Errors JavaScript

Our network