Page tree
Skip to end of metadata
Go to start of metadata


WordPress®, a web-based content management system, allows users to create a website or blog and hosting providers to manage updates through cPanel & WHM.

Install WordPress

cPAddons allow hosting providers to simplify and manage the installation and update of software for their users.

In order to allow users to install WordPress as a cPAddon, hosting providers must enable the WordPress cPAddon via WHM's Install cPAddons Site Software interface (Home >> cPanel >> Install cPAddons Site Software).

To enable WordPress installations as a cPAddon, perform the following steps:

  1. Navigate to WHM's Install cPAddons Site Software interface (Home >> cPanel >> Install cPAddons Site Software).
  2. Select the cPanel Blogs WordPress checkbox.
  3. Click Update cPAddon Config.

To moderate installations of WordPress as a cPAddon, perform the following steps:

  1. Navigate to WHM's Manage cPAddons Site Software interface (Home >> cPanel >> Manage cPAddons Site Software).
  2. Select the cPanel::Blogs::WordPress checkbox.
  3. Click Update Moderation.

To learn more about how to configure how the system handles cPAddons notifications and permissions, read our Tweak Settings - cPAddons Site Software documentation.

If available, users can easily install WordPress as a cPAddon with cPanel's Site Software interface (Home >> Software and Services >> Site Software).

To install WordPress as a cPAddon:

  1. Navigate to cPanel's Site Software interface (Home >> Software and Services >> Site Software).
  2. To receive a notice via email when the hosting provider installs WordPress, click here after the You currently are set to receive a notice when updates for your installs are available text.
  3. Click WordPress.

  4. Enter the requested information.

    1. To install WordPress directly into a domain's document root, leave the installation URL's path blank.


       This may overwrite any files already in the document root.

  5. Click Install.
    1. If your hosting provider moderates requests for WordPress installation, click Submit Moderation Request.
    2. Enter a note for your hosting provider, and click Submit Request.

  6. When the WordPress installation finishes, use your web browser to view the location that you entered in Step 4.
    • For example, if you installed WordPress in the directory, browse the location.

If WordPress is not available as a cPAddon, users can ask their hosting provider to add it, or they install WordPress directly themselves (see User installs WordPress directly).

If your hosting provider does not offer WordPress as a cPAddon, you can manually download WordPress from the WordPress website and install it on your site.

For more information, read installation instructions from WordPress and their cPanel-specific instructions on how to create a database for WordPress.

WordPress installation issues

Document root issues


In the following examples, the following statements are true:

  • represents the domain name.
  • example represents the account name.
  • subdomain represents a subdomain's directory.
  • represents an addon domain name.

Due to potential conflicts in the .htaccess file, do not configure multiple WordPress installations to share a single document root.

If you experience difficulties with WordPress, check the following requirements:

  • Each cPanel account user can host only one installation of WordPress in the document root directory.
    • The following are examples of document root directories:
      • /home/example/public_html/
      • /home/example/public_html/
      • /home/example/public_html/subdomain
  • Only one domain or subdomain can host a WordPress installation in any directory.
  • If the subdirectories are not a document root, cPanel account users can install additional WordPress installations in subdirectories under the domain's home/example/public_html directory.
    • The following examples demonstrate installations that use the wordpress subdirectory:
      • Under the document root for the main domain: /home/example/public_html/wordpress
      • Under a subdomain: /home/example/public_html/subdomain/wordpress
      • Under an addon domain: /home/example/public_html/

For more information, visit the WordPress website.

Database connection errors

If WordPress returns a database connection error, make certain that the database's name and password in the wp-config.php file are identical to the database credentials in your account.

For a document root installation, the wp-config file exists in the /home/username/public_html directory, where username represents the cPanel account name.

To change the database's username or password, use cPanel's MySQL Databases interface (cPanel >> MySQL >> Databases).

To test a username and password combination, run the following command (where db_user represents the database's authorized username):

mysql -u db_user -p

After you enter the command, enter the user's password. The system will respond with a success or failure message.

Additional documentation