9. Multi-domain certificates

General information about product

Recently Multi-Domain Certificates were added to Wvphost’s product list. These certificates are quite popular among customers, but require some additional configurations.

Multidomain certificates can be divided into 2 categories – old single domain products that now support additional domains as a configurable addon, and new multi-domain products that come with a predefined number of domains included in the product by default (more domains can be included additionally as well). Therefore number of domains included by default differs across the products. See the table for details:



Product name

Default number of domains (domain from CSR is counted here)

Maximum number of domains

Maximum number of domains that should be used in configurable options


PositiveSSL Multi-domain





Unified Communications





Setting up Multi-Domain Certificates


First of all, you need to set up product as described in ‘Setting up products and pricings’ section. After product is set up the default number of addon domains (from table above) will be available during activation.

In order to give your customers ability to order additional domains you need to set up configurable options for each multi-domain certificate you set up. It would not take much time.

  1. Go to configurable options and click on ‘Create a new group’ there.


  2. Fill in the name of your group (We recommend mentioning product name there) and select a product you wish to associate the configurable option with.



  1. Click ‘Add new configurable option’ button.


  1. Option Name. This field consists of two parts, the first one is internal and the other one is Visible to clients. Option name must contain ‘san|’ element. The text input after “|” will be displayed in your clients’ shopping cart.   We recommend  to specify default number of addon domains that are already included in certificate (For example – “san|Addon domains ( 3 domains are included by default)” for PositiveSSL MultiDomain.
  2. Select ‘Quantity’ as Option Type from dropdown menu. Click ‘Save changes’.
  3. Type 0 in ‘Minimum Quantity Required’ and the value from the last column of the table above as ‘Maximum Allowed’. For example, if you are setting up PositiveSSL Multi Domain, please input 97 as maximum.
  4. Use any name (it will not be shown anywhere) in the box next to ‘Add Option:’ and click ‘Save changes’.
  5. At this point you will see the table for pricing similar to one you’ve filled in during setting up product. Please fill in pricing for each additional domain for different terms.
  6. Click ‘Save changes’


That’s it. Now if your customer orders a multi-domain certificate he will be able to add some additional domains to his order.

Important Note: 

Please mention the default number of domains provided with Multi-Domain Certificates in product name or product description – this will guarantee your customers that even if they do not order any additional domains, they will have some of them added by default.


Managing addon domains after purchase is made.


Your client as well as you will be able to add more domains to a certificate after order is complete.

This can be done either from user and admin areas.

In order to do that in client area, your customer needs to mouse over ‘Management Actions’ and select ‘Upgrade/Downgrade Options’.


There your customer can increase number of addon domains. An attempt to decrease that number will cause error. A new hook was implemented in client area tracking attempts to decrease number of addon domains.

*Note*: Please make sure to tick the box on the screenshot below to have the ability to add a SAN to a multi-domain certificate.


Important Note: 

The number of addon domains can be changed from client area only after invoice for order is paid.

In order to complete the invoice manually, navigate to the "Billing" tab -> "Invoices" -> "Add Payment" tab -> click "Add Payment" button.





In order to change number of addon domains in WHMCS admin area, you need to access product page and manually input the new number of addon domains.

Please note that in case you decrease or increase this number here, you need to invoice/refund your client manually.


Important Note: 

In case you or your client increases number of addon domains for a certificate your Wvphost account will be charged for every extra addon domain used during activation/reissue.

For example, if your customer has ordered 2 more domains before reissue or you have manually increased number of addon domains by 2, your Wvphost account will be charged for 2 addon domains after reissue is complete from WHMCS client area.

 Activation of Multi-Domain Certificates.


Activation process is similar to activation of single-domain certificates. Below the CSR box you will see fields for additional domains.

It is not strongly required to fill in all the Addon Domain field during the first activation. Duplicate records are not allowed (including duplicates in CSR common name and addon domain fields).

Below is an example of first configuration page for PositiveSSL Multi Domain with 5 addon domains ordered (1 domain from CSR + 2 addon domains by default + 5 addon domains ordered separately).


The list of approver emails is different from the one you see on the second configuration page for single-domain certificates. It contains only local parts of email addresses that can be used for domain control validation. Once your customer selects one of the local parts, it will be added to every domain/subdomain input in Addon domains fields.
For example, if he selects “admin@” as approver email having “domain.com” as common name in CSR and “secure.domain.com” and “domain2.com” as addon domains, the approvals will be sent to admin@domain.comadmin@secure.domain.com and admin@domain2.com .

If your customer wishes to change email for one of the domains, he should contact you, and you in turn need to contact us via live chat or ticket system to have emails changed.

Such approver email selection flow on second configuration page is caused by certain limitations in WHMCS core.

  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

1. Before you begin

Wvphost.com SSL module for WHMCS is an open-source plugin that is distributed free of charge....

10. FAQs

I cancel certificate and nothing happens     Cancellation is being performed only in your WHMCS,...

2. Sandbox and Production environments

Wvphost has a production as well as a test server environment. The test server environment is...

3. Download and installation

Installation of module is very simple and takes just a few minutes:1. Download and extract...

4. Setting up products and pricing

To setup an SSL certificate product, please follow the steps below: 1. Open the Setup -...