WHMCS client area invoices

[jonathanMahapa]

 

Good day,

In the WHMCS client area, invoices are currently listed with the oldest invoice at the top and the newest at the bottom. How can I change this so that the most recent invoice appears at the top of the list?

Thanks

 

[WHMCS John]

Hi @jonathanMahapa,

The client area invoice list is sorted by status and then age, so that the oldest unpaid invoice is displayed first.

The table supports sorting by multiple criteria, so one can Ctrl + Click the "Unpaid" and "Invoice Date" columns to sort by status and see the newest/oldest invoices. 

You can also customise this in the template by changing the sort order attribute from asc to desc.

https://github.com/WHMCS/templates-twenty-one/blob/58393ff844e730f2c995a57b6a0834e0a003ded6/clientareainvoices.tpl#L8 

[Evolve Web Hosting]

On 1/8/2026 at 9:00 PM, WHMCS John said:

The table supports sorting by multiple criteria, so one can Ctrl + Click the "Unpaid" and "Invoice Date" columns to sort by status and see the newest/oldest invoices. 

@WHMCS John That is not intuitive at all for the end user (our customers). For the price increases we all just received, WHMCS should just fix this for all future releases. It will take a developer less than a minute to do so.

[wtools]

@WHMCS John at least is there a way to do it by some hook?  So we can set a default sorting behavior? 

Updating the template is a bad idea as it will be  gone during the WHMCS upgrade. 

 

[WHMCS John]

Hi @Evolve Web Hosting,

The oldest unpaid invoice is displayed first so that clients are guided to clear their most overdue debt to you first.

If a pluraliry of users would like us to change the default sort order, we can  certainly do so.

@wtools please use a Child Theme to retain your customisation on update.

 

 

[Evolve Web Hosting]

20 hours ago, WHMCS John said:

If a pluraliry of users would like us to change the default sort order, we can  certainly do so.

I don't think you need a majority of users to request this. It is pretty straightforward that unpaid invoices should be at the top followed by the most recently paid invoices.

[bear]

Plurality just means "the largest amount", which is not always the "majority". More like of 100 people, 36% said yes, 34 no and 30 undecided, the "yes" people would be the plurality. Of course, we might not learn the sampling group size, or if it's asked of anyone, so it's really vague.