# WHMCS 9 Upgrade & Compatibility Fixes

> Move from WHMCS 8 to 9.x with PHP 8.2+, Smarty 4 template fixes, module checks and a tested rollback plan.

A planned move from WHMCS 8.x to the 9.x branch: compatibility audit, PHP and ionCube updates, theme and hook fixes, gateway changes, staging tests and a rollback plan.

- **Price:** Starting at $299
- **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-9-upgrade
- **Last updated:** 2026-11-05

## Overview

Our WHMCS 9 upgrade service moves a self-hosted WHMCS 8.x install to the 9.x branch, with the compatibility work done on a staging copy before anything changes on your live site. It is for hosting companies, IPTV operators and VPS sellers who run custom themes, hooks or third-party modules and cannot afford a broken cart or a failed billing run.

## Why WHMCS 9 needs more than a normal update

WHMCS 9.0 reached general availability in January 2026 and 9.1 followed in October 2026. The 9.x branch changes more than a typical point release:

- **PHP 8.2 or newer is required.** PHP 8.1 is no longer supported, and WHMCS 9.1 needs ionCube Loader 15 installed before you update.
- **Smarty 4 replaces Smarty 3.** Legacy tags such as {php} and {include\_php} stop working in custom themes and order forms.
- **Invoices behave differently.** Corrections are recorded as credit and debit notes, and issued invoices are locked by default, which breaks hooks and scripts that edit invoices after they are sent.
- **Some modules and settings changed.** A few gateways were removed, Google mail importing needs OAuth2, the Plesk module needs a newer XML API, and direct web requests to the cron file are blocked by default.

WHMCS lists December 31, 2026 as the anticipated end-of-life date for 8.13, so most 8.x installs need a plan now. Check the WHMCS version lifecycle page for the current date before you schedule.

## What's included

- Audit of your PHP version, ionCube Loader, database server, theme, order form, hooks, addons and gateways
- WHMCS's Smarty and PHP version compatibility reports, plus a manual code review, because those reports do not catch everything
- A staging copy with outbound email, live gateway calls and provisioning switched off
- Template fixes that move legacy Smarty logic into hooks
- Hook and custom module fixes for PHP 8.2+ and the new invoice rules
- A vendor check on every third-party module, with a list of the ones that need an update or a replacement
- ionCube, WHMCS and PHP updates on production in the order WHMCS documents
- Post-upgrade checks on cron, invoicing, gateways, provisioning, email piping and the client area

## Who it's for

This service fits if you are on WHMCS 8.x and any of these apply: you use a custom or heavily edited theme, you rely on hooks that touch invoices, you run encoded modules from vendors that have gone quiet, or you want to switch to the new Nexus cart. If you are staying on your current branch for now and only need the latest patch release, our [WHMCS update service](/services/whmcs-upgrade-service) covers that instead.

## How it works

1. **Scoping call.** A free call about your version, server and customizations.
2. **Fixed-price quote.** You get a written quote within one business day.
3. **Audit on staging.** We clone the install, run the reports and list every blocker with the planned fix.
4. **Fixes and testing.** Themes, hooks and modules are updated and tested against WHMCS 9 on staging.
5. **Live upgrade.** A full backup, then the server and WHMCS updates in an agreed low-traffic window.
6. **Verification.** Test orders, test payments and a review of the next cron runs.

## Timeline

An install with a stock theme and a handful of modules usually takes 2 to 4 business days from quote approval. Installs with custom themes, many hooks or modules that need rework take 1 to 2 weeks. The live window itself is usually short and is scheduled around your quietest hours.

## Pricing

Pricing starts at $299 for a standard install with a small number of modules. Larger installs get a fixed price after the audit. Fixed-price work is billed 50% as a deposit and 50% on delivery, with three milestones for projects over $5,000, and every delivery includes a 14-day correction window. Work outside the quote is billed at $65 per hour. We accept Stripe (cards, Apple Pay, Google Pay), PayPal and crypto through NOWPayments.

## What's not included

- WHMCS license fees and third-party module renewals
- Changes to encoded third-party modules; we report them to the vendor or quote a rebuild
- A full theme redesign; see [WHMCS theme customization](/services/whmcs-theme-customization)
- WHMCS Cloud instances, since they do not give direct file or database access

## Related services

If your install has not been reviewed in a while, add a [WHMCS security audit](/services/whmcs-security-audit) before the move. After the upgrade, [monthly maintenance](/services/whmcs-monthly-support) keeps 9.x maintenance releases applied and tested. Ready to plan the move? [Start a project](/start-project) and tell us your current WHMCS version and PHP version.

## What's included

- Compatibility audit of PHP, ionCube Loader, database server, theme, hooks, addons and gateways
- Smarty compatibility and PHP version reports plus a manual code review
- Staging copy with email, live payments and provisioning disabled
- Legacy Smarty tags moved out of templates and into hooks
- Hook fixes for credit notes, debit notes and locked invoices
- Vendor status check for every third-party module
- ionCube, WHMCS and PHP updates applied in the documented order
- Full backup and written rollback plan before the live window
- Post-upgrade test orders, payments, provisioning and cron checks
- Short report of every change made

## Business outcomes

- Stay on a supported WHMCS branch before 8.13 reaches end of life
- Find broken templates and modules on staging instead of on your live cart
- Keep invoicing, suspensions and provisioning running through the change
- Know exactly which vendors still owe you a WHMCS 9 update
- Get onto PHP 8.2+ and the newer security releases in one planned step
- Have a tested way back if something unexpected shows up

## Frequently asked questions

### Do I have to upgrade to WHMCS 9 now?

You should plan it now. WHMCS lists December 31, 2026 as the anticipated end-of-life date for 8.13, and after end of life a version stops getting fixes.

### Should I move to WHMCS 9.0 or 9.1?

Usually 9.1, because it is the current release line. We only target 9.0 if a module you depend on does not support 9.1 yet.

### Will my custom theme still work on WHMCS 9?

Only if it has no legacy Smarty tags and no code that depends on removed features. We run the compatibility report, fix what it finds and test every changed page on staging.

### Can you upgrade PHP at the same time?

Yes, and it is usually required, since WHMCS 9 needs PHP 8.2 or newer. We update ionCube Loader, WHMCS and PHP in the order WHMCS documents, because the wrong order can take the install offline.

### What happens if something breaks after the upgrade?

We fix it or roll back to the backup taken right before the live window. Issues caused by our work are covered by the 14-day correction window.

### Do you support WHMCS Cloud?

No. WHMCS Cloud does not give direct file or database access, so this service is for self-hosted installs.
