# <ugm:addUserToGroup> Tag

The <ugm:addUserToGroup> tag adds the user corresponding to the provided username to the group corresponding to the provided groupName. Both the specified user and the specified group must previously exist for proper tag behavior. The tag has no enclosed body.

Execution of this tag requires the logged in user to have administrator rights.

Note: All User Management tags send results to the same file. If you are checking for results, include this import statement at the top of the page: <%@ page import="com.bea.p13n.usermgmt.taglib.UserManagementTagConstants" %>

## Syntax

<tagName attribute="value" />

## Attributes

atnProvider

Optional (String) - The name of the authentication provider to use. The default setting is the WebLogic Server DefaultAuthenticator. The authentication provider must provide write access. See Using Multiple Authentication Providers in Portal Development for more information.

username

Required (String) - The name of the user to be added to the group. Example: "<%=username%>"

groupName

Required (String) - The name of the group to which the user is being added. Example: "<%=groupName%>"

result

Required (String) - The name of an Integer variable to which the result of the add user to group operation is assigned.

Possible values:

- Success: UserManagementTagConstants.ADD_USER_OK.
- Error encountered: UserManagementTagConstants.ADD_USER_FAILED

## Example

This example shows how to use <ugm:addUserToGroup> to add a new user to an existing group.

    <ugm:addUserToGroup userName="<%=userName%>"
    groupName="<%=groupName%>"
    result="<%=result%>"/>

Related Topics

<ugm:addGroupToGroup> Tag