Citrix ADC – Add a Custom Notification to the Login Page

Reading Time: 2 minutes

Have you ever been in the situation when you need to inform the users about a downtime of the Citrix Gateway? In most of the cases the administrator will send out an email with information regarding the downtime of the service. But what if you do not have all the email address of the users? Wouldn’t be it fancy to have this information showing up before the user is logging in and starting to work? With the Rewriting feature of the ADC this is a very easy thing to do. Here is an example of a custom message visible under the login button.

Let me show you how its done. If we take a closer look at the login page with the developer options of our browser we need to find the location where we want to put our notification for the user. Use the element picker to determine the location.

With this information we can create the rewrite action and policy. We are going to insert our custom text after the ‘customAuthBottom’ class.

Bind the rewrite policy to the Gateway vServer. It is important to bind the rewrite policy as type RESPONSE.


  • This rewrite action will only work with the RfWebUI theme.
  • When using the X1 Theme you need to create a modified rewrite action.





  1. Great article. Just what I am looking for to alert my end users of upcoming downtimes and other messages I need to get out to my users. However, I am having an issue building the rewrite action in the GUI. I keep getting an error message, “Target must be a simple reference to an unmodified portion of the message”. I am not sure where the issue lies when trying to create the action. I am using firmware NS 13.0 79.64.

    Thoughts ? And Thx!

  2. I am trying this very thing, and after creating the rewrite policy I see the policy hits incrementing, but no text is displayed. What more should I try?

  3. As clear as crystal ! Thanks for the very useful and simple instructions.
    I had to display a security warning on the logon page, you saved my day !
    Great !

Leave a Reply

Your email address will not be published. Required fields are marked *