SharePoint Stack Exchange is a question and answer site for SharePoint enthusiasts. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

How can I add a custom user control to a page layout?

I have some custom user control developed. I want to place it in a custom page layout. So it will be in every page instance of that layout.

share|improve this question
up vote 8 down vote accepted

First create your User Control and publish is to SharePoint.
Then you register a tag for your control

<%@ Register Tagprefix="MyControls" 
    Assembly="KM.MyControls, Version=, Culture=neutral, PublicKeyToken=<Your token>" %>

Then you can reference your User Control

<MyControls:MyUserControl runat="server"/>
share|improve this answer

Make sure you put the user control into a subdirectory of {SharePointRoot}/Templates/ControlTemplates

Put a Register element at the top of you page-layout

<%@ Register TagPrefix="MyOwnPrefix" TagName="MyUserControl" Src="~/_controltemplates/MyProjectName/UserControl.ascx" %>

and the refer to it where you need it like:

<MyOwnPrefix:MyUserControl runat="server" id="userControl" />
share|improve this answer
thank you, how should i deploy user control via solution? should i deploy it via module in a visual studio solution? – ozdogan Sep 28 '12 at 6:52
Create a Mapped folder to {SharePointRoot}/Templates/ControlTemplates create a subdirectory and put the UserControl there – Per Jakobsen Sep 28 '12 at 6:57
Thats it! Thank you. – ozdogan Sep 28 '12 at 7:01

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.