# WHMCS Customer Portal Customization

> New dashboard panels, menu items, pages and service screens in the WHMCS client area, without touching core files.

Client-area features for WHMCS: homepage panels, menu hooks, custom pages, service detail screens with panel data and permission-aware actions.

- **Price:** Starting at $199
- **Billing:** One-time, fixed scope
- **Category:** WHMCS
- **Quote turnaround:** Fixed-price quote within 24 hours
- **Start a project:** https://whmcspilot.com/start-project
- **Details:** https://whmcspilot.com/services/whmcs-customer-portal
- **Last updated:** 2026-11-05

## Overview

WHMCS customer portal customization adds to, or reshapes, what logged-in customers can do and see in the client area: dashboard panels, menu items, extra pages, service detail screens and the fields they fill in. It is for providers whose customers keep opening tickets for information WHMCS could show them directly, such as IPTV line details, VPS credentials or renewal dates. Projects start at $199 as a one-time fee. Colors, fonts and layout are a separate job, [theme customization](/services/whmcs-theme-customization), and when you need both we price them on one quote.

## Typical requests

- Dashboard panels on the client-area home page, added through the ClientAreaHomepagePanels hook: next renewal, unpaid balance, service status, an upgrade offer
- Menu edits through the ClientAreaPrimaryNavbar and ClientAreaPrimarySidebar hooks, such as dropping Network Status for a host that never posts outages, or showing a Downloads link only to customers who own a licensed product
- New pages, for example a referral summary, a usage report or a reseller price sheet, built on the WHMCS ClientArea class or an addon module's client-area output so they keep the login, breadcrumbs and active theme
- Service detail screens (clientareaproductdetails.tpl) that display what the provisioning module knows: M3U and portal URLs for IPTV lines, VPS IP addresses with a root password reset button, license keys
- Extra client custom fields at signup or on the profile, with validation, plus product custom fields asked at order time
- User permission cleanup in User Management, so a client's bookkeeper can open invoices without seeing service passwords

## How the code stays upgrade-safe

Everything lives in hook files under /includes/hooks/, an addon module under /modules/addons/ or child-theme templates. WHMCS core files are never edited. Data is read through the internal API (localAPI) or the Capsule database layer instead of hand-written queries against tables that WHMCS may restructure. Any button a customer can press, a password reset for instance, first confirms that the logged-in user owns the service and holds the right permission. Templates avoid the Smarty tags dropped in WHMCS 9, so the same code runs on 8.13 (PHP 8.1 and up) and on 9.0 or 9.1 (PHP 8.2 and up).

## Before we quote

We ask for the questions customers send to support most often. That list usually shows what belongs on the dashboard and what can stay buried. We also check which provisioning modules you run, because details like IPTV lines or VPS addresses have to come from the module or the panel's API, and a few encoded third-party modules keep that data to themselves. If a module is the blocker, you will hear it before you pay anything.

## What we need from you

- Admin login plus SFTP or cPanel File Manager access
- A test client account holding one active service of each type you sell
- API credentials for any panel the portal should read from, read-only where the panel supports it
- Wording for new labels in every language your client area offers

## Deliverables

- Hook files, templates or an addon module installed on your site, with source code
- A test log showing each new panel, menu item and page checked as a client with and without the relevant service, on desktop and phone
- New labels added through language override files, not the core language files
- A list of every file added, so future updates and future developers do not trip over it

## Pricing

ScopePriceOne or two homepage panels, or a set of menu changesFrom $199, one-timeA new client-area page built on WHMCS dataFixed quoteService detail screen pulling live data from an external panel APIFixed quoteA steady stream of small additions$65 hourly, or a $650 block of 10 hours per week

Panel and menu jobs normally take two to four business days. Pages that call an outside API take longer, and the quote gives a firm date. The fee is split into a 50% deposit and a final 50% on delivery, and in-scope faults reported within 14 days are fixed at no charge.

## Not included

- Changing colors, fonts or page layout (see the theme service linked above)
- Staff-side screens and reports, covered by [admin panel customization](/services/whmcs-admin-customization)
- Invoice and quote layouts, handled under [invoice and PDF customization](/services/whmcs-invoice-customization)
- Complete provisioning modules for a new panel, which is [custom module development](/services/whmcs-module-development)
- Native iOS or Android apps

Write the three questions your customers ask support most often on the [project form](/start-project). They nearly always point to what the portal is missing.

## What's included

- Dashboard panels added through the ClientAreaHomepagePanels hook
- Navbar and sidebar changes through the client-area menu hooks
- New pages that keep the login, breadcrumbs and active theme
- Service detail screens showing data from your provisioning module or panel API
- Client and product custom fields with validation
- Ownership and permission checks before any customer action runs
- Labels added through language override files
- Code kept in hooks, addon modules or child-theme templates only
- Test log covering customers with and without each service

## Business outcomes

- Fewer tickets asking for details WHMCS already stores
- Customers see renewals, balances and service data on the first screen
- Updates leave the work alone because no core file is modified
- Account contacts only reach what their permissions allow
- Portal additions carry over to WHMCS 9 without a rewrite

## Frequently asked questions

### How is this different from theme customization?

Theme work changes how the client area looks; portal work changes what it does and shows. Many projects need both, and one quote can cover the pair.

### Can the client area show details from my IPTV or VPS panel?

Yes, when the provisioning module or the panel's API exposes them. We check your modules during scoping, because some encoded modules keep that data internal.

### Will my portal changes break when WHMCS updates?

They should not, since they live in hooks, addon modules and child-theme templates that updates do not overwrite. After a major release, a short test on staging is still wise.

### Can I hide client-area menu items nobody uses?

Yes. Menu hooks can remove, rename, reorder or conditionally show any navbar or sidebar item, for example a Downloads link that only appears for customers with a licensed product.

### Do new pages work in every language my client area offers?

Yes, because each label is a language string with its own entry per language. You supply the translated wording, or your usual translator does.

### When is the balance due?

After you have tested the changes on your install. The deposit is 50% of the quote, and anything in scope that fails during the next 14 days is fixed free.
