In cPanel & WHM version 56 we introduced a new tool to answer one of the most highly voted feature requests: “As a webhosting provider, I want to be able to convert an addon domain into its own account. In version 58 we expanded the feature, and today I want to introduce you to it: the Convert Addon to Account tool. This tool allows both the root user and resellers with the Super Privilege “Rearrange Accounts” to extract an existing Addon Domain from a cPanel account into its own cPanel account with just a few clicks. Let’s take a look!
The WHM Interface
Once you’re logged in to WHM, choose the “Convert Addon Domain to Account” tool from the sidebar. You will then be presented with a list of Addon domains and their associated cPanel username. Use the search box at the top of the list to reduce the number of displayed domains, or click the navigation buttons along the bottom to scroll through all the addon domains. Once you locate the domain you want to extract, click “Convert”.
You will then be taken to a second interface where you are allowed to choose the new username, define the new account’s package, and a slew of other options.
Logs for each conversion are stored on the server and are viewable in the same WHM interface. Here’s one example (including an example warning that is normal in our testing environment):
The Command Line Option
Using cPanel & WHM’s command line utilities you can easily initiate an addon-to-account conversion on the command line as well. In this case you will use the convert_addon_initiate_conversion WHMAPI1 call. For example, to extract the bvcptestaddon2.com domain to a new cPanel account bvcp2addon, you would use this command:
whmapi1 convert_addon_initiate_conversion domain=bvcptestaddon2.com user=bvcp2addon
Check out the convert_addon_initiate_conversion documentation for more information on that API call,
It’s that easy!
If you aren’t familiar with the Command Line Utilities (introduced in 11.52) take a look at the blog post from earlier this year: cPanel’s Command Line API Tools, or you can come see my talk (Automate everything with cPanel & WHM APIs) at this year’s cPanel conference in Portland, Oregon (October 3rd – 5th)!
The conversion tool is incredible straight forward, and is very easy to use. If you have any questions about it or the API tools feel free to reach out to our support team, find me on twitter, or send me an email!