How to Modify a Hosting Account in cPanel/WHM Print

  • account modification, change username, cpanel whm, account settings, resource limits, account management, hosting account, dns settings
  • 0

To modify a hosting account in cPanel/WHM, navigate to the account management interface, select the account you want to change, click the modify option, make your desired changes to settings like domain, username, resource limits, or privileges, and then save your changes. Most modifications take effect immediately, though changing usernames requires special consideration due to potential impacts on databases and websites.

Account modification is a common administrative task that allows you to update account details, adjust resource allocations, change security settings, and manage account features. Understanding the proper process helps you avoid service interruptions and maintain account integrity.

How to Modify an Account Step-by-Step

Follow these steps to modify an existing hosting account:

  1. Select the account you want to modify from your account list
  2. Click the Modify or Edit button next to the account name
  3. Make your desired changes in the available sections (basic information, resource limits, privileges, DNS settings, or package extensions)
  4. Click Save to apply your changes

When you modify resource limits, privileges, DNS settings, or package extensions, you may see a package conflict resolution dialog. This appears when your changes differ from the account's assigned package settings, allowing you to choose whether to override the package or create custom settings for that specific account.

Modifying Basic Account Information

The basic information section lets you change fundamental account details:

Changing the Primary Domain

You can update the primary domain associated with an account. This changes the main website address for the account. Be aware that changing the primary domain may affect email delivery, SSL certificates, and existing website links.

Changing the Account Username

Usernames can be modified, but this requires careful consideration. Your new username must meet specific requirements:

  • Must be unique and contain 16 characters or fewer
  • Must contain only letters and numbers (no special characters or spaces)
  • Cannot start with a number or the word "test"
  • For MySQL or PostgreSQL databases, the first eight characters must be unique on the system to prevent database prefix conflicts (this restriction does not apply to MariaDB servers)

Important considerations when changing usernames:

  • Choose a new username that is the same length or shorter than the current one. Longer usernames may cause MySQL to truncate database names and usernames, leading to functionality issues
  • Websites and databases become temporarily unavailable while data transfers to the new username
  • Hard-coded references to the old username in scripts, configuration files, or applications will break and need manual updating
  • Email accounts may experience temporary delivery issues during the transition
  • Only the root administrator can rename a self-owned reseller account

If you need to change a username, plan for a maintenance window and notify the account owner in advance to minimize disruption.

Modifying Resource Limits

Resource limits control how much server resources an account can consume. You can adjust:

  • Disk space quota
  • Bandwidth allocation
  • Maximum number of email accounts
  • Maximum number of databases
  • Maximum number of subdomains
  • CPU and memory limits (if configured on your server)

Increasing resource limits allows accounts to host larger websites or handle more traffic. Decreasing limits can help manage server load or enforce hosting plan restrictions. Changes to resource limits typically take effect immediately, though accounts currently exceeding new lower limits may need to reduce usage before adding new content.

Modifying Account Privileges

Account privileges determine which features and tools are available to the account owner. You can enable or disable features such as:

  • Shell access (SSH)
  • CGI script execution
  • Email functionality
  • Database creation
  • DNS zone editing
  • SSL certificate management

Restricting privileges enhances security by limiting what account owners can do, while granting additional privileges gives advanced users more control over their hosting environment.

Modifying DNS Settings

DNS settings control how domain names resolve to IP addresses. In the DNS section, you can:

  • Change nameserver assignments
  • Enable or disable DNS clustering
  • Modify DNS zone file settings
  • Configure custom DNS records

DNS changes may take time to propagate across the internet, typically ranging from a few minutes to 48 hours depending on TTL settings and DNS cache refresh cycles.

Modifying Package Extensions

Package extensions are additional features or overrides specific to an account. You can configure:

  • Custom features beyond the assigned package
  • Feature overrides that differ from package defaults
  • Account-specific settings that persist even if the package changes

This allows you to customize individual accounts while maintaining standardized packages for most users.

Best Practices for Account Modification

Follow these recommendations when modifying accounts:

  • Notify account owners: Inform users before making changes that might affect their service, especially username changes or resource limit reductions
  • Schedule maintenance windows: Perform significant changes during low-traffic periods to minimize impact
  • Backup first: Create a backup before making major changes, allowing you to restore the previous configuration if problems occur
  • Document changes: Keep records of what was changed and why, helping with troubleshooting and future planning
  • Test after changes: Verify that websites, email, and databases work properly after modifications
  • Review dependencies: Consider how changes might affect related services like email routing, SSL certificates, or third-party integrations

Common Account Modification Issues

Username Changes Breaking Applications

When you change an account username, applications with hard-coded paths or database connections may fail. You need to update configuration files, database connection strings, and any scripts referencing the old username.

Resource Limit Conflicts

If you reduce disk space or bandwidth limits below current usage, the account may experience service disruptions. Users need to reduce their usage before the new limits fully apply.

DNS Propagation Delays

DNS changes don't take effect immediately worldwide. Different visitors may see different versions of a website during the propagation period. You can reduce TTL values before making changes to speed up propagation.

Email Delivery Problems

Changing primary domains or usernames can temporarily disrupt email delivery. Email sent during the transition may bounce or be delayed. Inform users to expect possible email issues and verify email functionality after changes complete.

Frequently Asked Questions

Can I change multiple account settings at once?

Yes, you can modify multiple settings in a single edit session. Make all your desired changes before clicking save, and all modifications will be applied together. This is more efficient than making changes one at a time.

Will modifying an account cause downtime?

Most account modifications, such as changing resource limits or enabling features, take effect without causing downtime. However, changing the username or primary domain can cause temporary unavailability while data transfers and DNS updates propagate. Plan accordingly and choose low-traffic times for these changes.

What happens if I change an account username?

Changing an account username moves all account data, including files, databases, and email, to a new location matching the new username. This process causes temporary downtime. Additionally, any hard-coded references to the old username in scripts or configuration files will break and require manual updates. Database names and usernames may also be affected, especially if the new username is longer than the old one.

How do I undo account modifications if something goes wrong?

If you backed up the account before making changes, you can restore from that backup. Otherwise, you'll need to manually revert the changes by accessing the account modification interface again and entering the previous values. This is why creating backups before major modifications is strongly recommended.

OBHost's support team is available 24/7 to help with account modifications and troubleshooting any issues that arise. If you need assistance modifying accounts or have questions about specific settings, visit our contact page or email support@obhost.org.


Was this answer helpful?

« Back