SP.UI.Status.addStatus(strTitle, strHtml, atBegining) Method

SharePoint 2010

Last modified: January 12, 2011

Applies to: SharePoint Foundation 2010

Adds a status message to the page.

var value = SP.UI.Status.addStatus(strTitle, strHtml, atBegining);


The title of the status message.


The contents of the status message.


Specifies whether the status message will appear at the beginning of the list.

Type: String – The ID of the status message.

The following example creates input buttons on an application page that display and remove alert notifications and status messages.

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<script type="text/ecmascript" language="ecmascript">

var statusId = '';
var notifyId = '';

function AddNotification() {
    notifyId = SP.UI.Notify.addNotification("Hello World!", true);

function RemoveNotification() {
    notifyId  = '';

function AddStatus() {
    statusId = SP.UI.Status.addStatus("Status good!");
    SP.UI.Status.setStatusPriColor(statusId, 'red');

function RemoveLastStatus() {
    statusId = '';

function RemoveAllStatus() {


    <input id="Button1" type="button" value="Add Notification" onclick="AddNotification()" />
    <input id="Button2" type="button" value="Remove Notification" onclick="RemoveNotification()" />
    <input id="Button3" type="button" value="Add Status" onclick="AddStatus()" />
    <input id="Button4" type="button" value="Remove Last Status" onclick="RemoveLastStatus()" />
    <input id="Button5" type="button" value="Remove All Status" onclick="RemoveAllStatus()" />