Magento 2 with WordPress as a blog. How does it work?

WordPress is particularly good at content management, and is used as an alternative option to Magento 2' CMS. Consequently, the two systems need integrating together somehow.

As a Magento Developer in Sussex and having worked with local digital agencies, many clients were fond of using previous knowledge of WordPress together with the powerful ecommerce platform of WordPress.

Fortunately, there are some great developers in the programming community. One of whom has created the FishPig Magento WordPress Integration extension.

Now I'll run through the steps required to integrate the two systems together. I've written steps here to integrate WordPress with Magento 1 should you wish to check out that post.

Configure WordPress

Assuming you have a working Magento 2 instance already, download the latest version of WordPress and place the file contents within a wp subdirectory in the Magento root.

You are then be able to access the WordPress installation page from the /wp route of your Magento store.

Run through the installation process. Note that you can use the existing Magento database or a separate one when WordPress asks for database connection details.

Configure the Site Address URL

You might not want /wp as the URL that shows up for WordPress, and this can be changed from within the WordPress admin. Many merchants like to use /blog or /media as the URL to manage their CMS content.

Head to Settings -> General and change the Site Address (URL) option to the URL of your choice.

Install the FishPig extension

Within your Magento 2 instance, create a FishPig/WordPress directory within Magento 2's app/code directory.

Download the FishPig Magento WordPress Integration extension and within the directory downloaded, copy the contents into the created FishPig/WordPress directory.

The extension is enabled by running the enable database upgrade commands.

$ path/to/php bin/magento module:enable FishPig_WordPress
$ /path/to/php bin/magento setup:upgrade

Clear the Magento cache and a FishPig configuration section will appear within Stores -> Configuration.

Final configuration tweaks in WordPress

Log back into the Magento admin, and a few things should be configured correctly.

First of all, there is a FishPig Magento 2 Integration theme that needs to be activated for the integration to work. In WordPress, this is located under Appearance -> Themes.

Secondly, it's a good idea to enable Post Name permalinks for SEO friendly post URLs. This can be enabled within Settings -> Permalinks.

Finally, security is key. WordPress, being used by millions of websites, is often a popular target of web attacks. Ensure that you undertake the recommended security practices in order to keep both WordPress and Magento sites safe.


In conclusion, the steps provided to integrate WordPress with Magento 2 are fairly straightforward. From a freelance Magento 2 developer point of view, there shouldn't be too many problems faced when implementing this integration.

If you do have any troubleshooting issues, contacting the extension author is where you're most likely to get a solution. However, if you need any help from me regarding the integration or further Magento help, feel free to use the contact form on the website to get in touch.