The best place to document this would be in https://symfony.com/doc/current/security/user_checkers.html . In the example the - not existing - AccountDeletedException line can be replaced with this new class. The "If one or more conditions are not met, an exception should be thrown which extends the AccountStatusException:" sentence above the example can then be tweaked to also mention this new exception.