# <um:createGroup> Tag

The <um:createGroup> tag reates a new group in the realm, and a corresponding group profile in the personalization database. This 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. servlets.jsp.tags.UserManagementTag- Constants" %>

## Syntax

<tagName attribute="value" />

## Attributes

groupName

Required (String) - The name of the new group. Example: "<%=groupName%>"

id

Optional (String) - A variable name to which the created Group object is available for the duration of the page's scope.

parentName

Optional (String) - The name of the group to set as the parent of the new group.

result

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

Possible Values:

- Success: UserManagementTagConstants.CREATE_GROUP_OK.
- Error encountered: UserManagementTagConstants.CREATE_GROUP_FAILED.
- A group with the specified group name already exists: UserManagementTagConstants.GROUP_EXISTS.

## Example

This example shows how to use <um:creategroup> to create a new group.

    <um:creategroup groupName="<%=groupName%>" result="result"/>

Related Topics

<um:createUser> Tag