How to stop ASP.NET from changing IDs in order to use jQuery

I have this label control in my web page

<asp:Label ID="Label1" runat="server" Text="test"></asp:Label>

And when the page rendered the id of the control changes to something like this

  <span id="ctl00_ContentPlaceHolder1_Label3">test</span>

How can I stop from changing IDs in order to perform a jQuery operation like this



Thank you for visiting the Q&A section on Magenaut. Please note that all the answers may not help you solve the issue immediately. So please treat them as advisements. If you found the post helpful (or not), leave a comment & I’ll get back to you as soon as possible.

Method 1

Short answer:

Set ClientIDMode="Static"

<asp:Label ID="myLabel" ClientIDMode="Static" runat="server" Text="testing"></asp:Label>

Long answer:

.NET 4 now has the ability to let you choose your ClientIDMode:

Type: System.Web.UI.ClientIDMode
A value that indicates how the ClientID property is generated.

The ClientID value is generated by concatenating the ID values
of each parent naming container with the ID value of the control. In
data-binding scenarios where multiple instances of a control are
rendered, an incrementing value is inserted in front of the control’s
ID value. Each segment is separated by an underscore character (_).
This algorithm was used in versions of ASP.NET earlier than ASP.NET 4.

The ClientID value is set to the value of the ID property. If
the control is a naming container, the control is used as the top of
the hierarchy of naming containers for any controls that it contains.

This algorithm is used for controls that are in data-bound
controls. The ClientID value is generated by concatenating the
ClientID value of the parent naming container with the ID value of the
control. If the control is a data-bound control that generates
multiple rows, the value of the data field specified in the
ClientIDRowSuffix property is added at the end. For the GridView
control, multiple data fields can be specified. If the
ClientIDRowSuffix property is blank, a sequential number is added at
the end instead of a data-field value. This number begins at zero and
is incremented by 1 for each row. Each segment is separated by an
underscore character (_).

The control inherits the ClientIDMode setting of its NamingContainer control. This is the default.

Method 2

instead of using this selector


use this one, basically you are using the classic asp inline server side code.

$('#<%= Label1.ClientID %>')

this will insert whatever ID that is generated to be placed as a literal.

If you wish to use external files then I would suggest you create an obj that is global on the page to hold all of your client ids and then reference that obj within your external files (not ideal but it is a solution)

var MyClientIDs = {
    Label1 = '<%= Label1.ClientID %>',
    Label2 = '<%= Label2.ClientID %>',
    Textbox1 = '<%= Textbox1.ClientID %>',
    Textbox2 = '<%= Textbox2.ClientID %>'

and then in your external file you can access Label1 for example: $('#' + MyClientIDs.Label1)

Method 3

In .NET 4+ set ClientIDMode="Static". This will solve your problem.


<asp:Label ID="Label1" ClientIDMode="Static" runat="server" Text="test"></asp:Label>

Method 4

You can’t stop from generating those IDs. That’s just how it does things.

You can still use jquery like so:

$('#<%=label1.ClientID %>').html(xml)



Method 5

If and only if you’re container layout is never going to change and you require to put your JavaSctipt/jQuery in an external file, you could use the generated ids within your jQuery selectors i.e.


Obviously, this approach requires you to find out what the generated ids will be and requires caution if you ever start changing the site/application construction.

Otherwise, your best options are

1. Use the inline server side code markup. The downside to this approach is that you cannot put your js code in an external file –

$('#<%= Label3.ClientID %>').html(xml);

2. Define unique CSS classes on each control you need to use in your jQuery, which would still allow you to put your js code in an external file –

<asp:Label ID="Label3" runat="server" Text="test" CssClass="label3">


3. Use jQuery selectors to pattern match the original id, which again, would allow you to put your js code in an external file –


This jQuery selector will select all elements with attribute id whose value ends with Label3. The only potential downside that I could see with this approach is that in theory, it could be possible to have a Label control with id Label3 in say, a Master page and also in two content pages. In this example, using the jQuery selector above would match all three labels, which may have unwanted consequences.


I thought it might be useful to raise your attention to the IDOverride control. An Example page can be found here

It allows you to specify which controls should have their mangled id within the outputted HTML markup overridden with the id as is given in the .aspx file when rendering out the HTML page. I have only played with it briefly with a single Master Page and Panels, but it appears to work well. Using this, you could use the original ids within your jQuery selectors. Be aware however, that the results are unpredictable if you were to have controls with the same ids in your Master page(s) and Content page(s) that are combined to render the HTML for one page.

Method 6

Short answer, don’t worry about using the IDs. In you can add your own attribute to a tag:

<asp:TexBox ID="myTBox" runat="server" MyCustomAttr="foo" />

Then in jquery you can refer to this element via:


I do this all the time with jQuery. Hope it helps.

Method 7

You can call a class name rather than using an ID

For example;

$('.CssClassName'). ...

Or if you type this in the MasterPage’s very first line, your control IDs won’t change :


For example;

<%@ Master Language="C#" AutoEventWireup="true" CodeFile="MasterPage.master.cs" Inherits="Main_MasterPage" ClientIDMode="Static" %>

Method 8

The inline code is the correct way to do it. However this will be changing in ASP.NET 4.0. We have spent some time adding a feature that allows full control of the IDs that are generated client side. Below are some resources on the web about this feature.

Method 9

Most of the suggestions here will work, but test results on jQuery code show that pure ID selectors are by far the fastest. The one I use most often:


is pretty slow, but the problem isn’t too apparent unless the page has many controls and a lot of jQuery.

Since is it fairly painless to assign multiple classes to a control, you could give each one a CSSClass that matches the ID. Since they would then be unique (you’ll have to watch repeater type controls that generate multiple controls), you could select by class.

For example:

<asp:Label ID="Label1" CssClass="Label1 SomeOtherClass" runat="server" Text="test">

could be selected uniquely by:


Which is almost as fast as an ID select.

I had never considered this one:

$('#<%= Label1.ClientID %>')

but I’m going to try it!

Method 10

You have to pass the control’s ClientID to the javascript code (I doubt though that Label1 gets renamed to Label3)

ClientScriptManager.RegisterClientScriptBlock(GetType(), "someKey", 
    "$('#" + Label1.ClientID + "').html(xml);", true);

Method 11

You can use the ClientID (just like everyone else said) but the problem with that is that it cannot be used in an external JavaScript File.

So, ideally, instead of using the ID to reference it from jQuery, use a CSS class:

<asp:Label ID="Label1" runat="server" Text="test" CssClass="myclass"></asp:Label>

Then you can reference it like such:


Method 12

You can override the ClientID and the UniqueID as this fella did.

/// <summary>
/// Override to force simple IDs all around
/// </summary>

public override string UniqueID
        return this.ID;

/// <summary>
/// Override to force simple IDs all around
/// </summary>

public override string ClientID
        return this.ID;

Method 13

You may also create a custom control that inherits from Label that overrides the ID property to be what you want it to be.

Method 14

This can be achieved by replacing the id with the original id as the control is rendered.
This is pretty easy and can be donw by creating a set of custom controls.

Method 15

At the risk of being patently obvious change:

<asp:Label ID="Label1" runat="server" Text="test"></asp:Label>


<Label ID="Label1" Text="test"></Label>

Method 16

You need to put the property ClientIDMode="Static" in your button, this grants the ID will be the same in runtime, it’s what you need to get object in Javascript.

Method 17

you don’t need to “prevent” from changing the control id in order to use jquery, or javascript at all for that matter.

the id that gets rendered on your page is the ClientID property of the control and what you’re setting on the control itself is the ID. you can’t set the ClientID property, it’s generated for you and may or may not be the same as your ID. however, as others have mentioned you can use the ClientID property either in your aspx:

$('<%= Label1.ClientID %>').html()

or by registering the client script in your code behind file using one of the ClientScriptManager methods.

Method 18

Just get rid of the placeholder. Or select by class or DOM hierarchy. Or even use partial matching on the ID as a last resort. There are many easy, clean ways to select an element in jQuery, we need to wean ourselves away from our old, ugly ASP.NET habits.

And Dreas Grech put the final nail in the coffin. You can’t use use external script files with the $(‘#<%=label1.ClientID %>’) type solutions.


Method 19

You still can use PlaceHolders and set ClientIDMode in the PlaceHolder tag :

<asp:ContentPlaceHolder ID="BodyContent" runat="server" ClientIDMode="Static">        

None of the contained controls IDs will be altered.

Method 20

Simple, with overriding the control class. Here is an example with an HtmlGenericControl but you can do it with any ASP.Net control:

public class NoNamingContainerControl : HtmlGenericControl
    public NoNamingContainerControl(string tag) : base(tag) { }
    public override string ClientID
            return this.ID;

All methods was sourced from or, is licensed under cc by-sa 2.5, cc by-sa 3.0 and cc by-sa 4.0

0 0 votes
Article Rating
Notify of

Inline Feedbacks
View all comments
Would love your thoughts, please comment.x