---
title: "Managing Group Attributes"
slug: "engage-managing-group-attributes"
status: "new"
updated: 2026-07-30T07:47:01Z
published: 2026-07-30T07:47:01Z
canonical: "docs.mapp.com/engage-managing-group-attributes"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Group Attributes

## Goal

Create, import, export, or delete group attributes in Mapp Engage.

---

## Background Information

Group attributes apply to all members of a group and always have the same value for every member. You can create group attributes manually in the user interface or by importing them via XML or CSV files.

The group for which you create the attribute must already exist in Mapp Engage.

The value you define applies to all members of the selected group. The maximum length of an attribute value is 2000 characters.

### Character Limitations for Attribute Names

When creating attribute names in Mapp Engage, observe the following rules.

#### Strict limitations

- Leading or trailing whitespace is not allowed.
- The period (`.`) character is not allowed.

#### General recommendation

- Use only alphanumeric ASCII characters, letters a–z, A–Z, and digits 0–9.
- Avoid special characters such as `' " - < > : , ; | / & `` to prevent processing issues.

#### Other rules

- Maximum length: 100 characters
- Attribute names are not case-sensitive

---

## Creating Group Attributes

You can create a group attribute manually in the user interface.

1. In the top navigation, click **Create New** > **Attribute**, or navigate to *Administration > Attributes > Group Attributes*.
2. Click **Create new Attribute**.
3. In the **Attribute Name** field, enter a name for the new attribute.
4. Select **Group Attribute** as the **Attribute Type** if it is not already preselected.
5. From the **Group** drop-down list, select the required group.
6. In the **Value** field, enter the value for the group attribute.
7. Click **Save & Close**.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image-1QFU6B5L.png)

---

## Importing Group Attributes

You can import group attributes into a group using an XML or CSV file.

### Prerequisites

Before importing group attributes, ensure the following:

1. **Existing Group**: The target group must already exist in Mapp Engage.
2. **File Format Requirements**:
  - The file should not exceed 1,000 attributes.
  - Attributes must use the `string` data type.
  - Null (empty) values are not permitted.
3. **Separate Files**: Group attributes must be in a dedicated file separate from contact data imports.

---

### Import Configuration

When importing, you will need to specify the following details:

1. **File**: Enter the file path manually or select the file using the **Browse** button.
2. **File Type**: Choose between **CSV** or **XML**.
3. **Character Set**: Select the file's character encoding. Refer to [Character Encoding](http://en.wikipedia.org/wiki/Character_encoding) for more information.
4. **Import Mode**: Choose how the imported attributes interact with existing attributes:
  - **Add**: Adds new attributes without modifying existing ones.
  - **Replace**: Replaces all existing attributes with the new ones.
  - **Delete**: Deletes existing attributes before importing the new ones.
  - **Add and Update**: Adds new attributes and updates any existing ones. Attributes not in the file remain unchanged.
  - **Update**: Updates existing attributes without adding new ones.
5. **Separator**: For CSV files, specify the delimiter. The default is a comma (,).

After configuration, click **Upload**. An email confirmation will be sent upon successful import.

> [!NOTE]
> Note
> 
> Selecting the correct character set is critical. If the wrong encoding is chosen, the imported data may be displayed incorrectly.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image(791).png)

---

### File Structure Requirements

#### XML File Format

An XML file must include the following components:

- **XML Declaration**: Specifies the XML version and character encoding.
- **Tags**: Each XML element must have a start tag (`&lt;elementname&gt;`) and an end tag (`&lt;/elementname&gt;`).
- **Elements**: Use the following elements:
  - `&lt;groupattributes&gt;`: Wraps all attribute data. Include the XML namespace attribute (`xmlns="http://webservices.ecircle-ag.com/ecm"`).
  - `&lt;groupattribute&gt;`: Defines a single attribute.
    - `&lt;name&gt;`: Specifies the attribute name.

> [!NOTE]
> Note
> 
> If a group attribute with that name exists in the group, Mapp Engage updates the value of the existing attribute. If a group attribute with that name does not exist in the group, Mapp Engage creates a group attribute.
    - `&lt;value&gt;`: Specifies the attribute value.

**Example**

```xml
<groupattributes xmlns="http://webservices.ecircle-ag.com/ecm">
    <groupattribute>
        <name>Flight</name>
        <value>Frankfurt - Paris €299</value>
    </groupattribute>
    <groupattribute>
        <name>Hotel</name>
        <value>SuperFrenchLuxuryHotelChain</value>
    </groupattribute>
    <groupattribute>
        <name>Destination</name>
        <value>Explore Paris!</value>
    </groupattribute>
</groupattributes>
```

---

#### CSV File Format

The CSV file header must include the following columns:

- `"group.PropertyName"`

> [!NOTE]
> Note
> 
> If a group attribute with that name exists in the group, Mapp Engage updates the value of the existing attribute. If a group attribute with that name does not exist in the group, Mapp Engage creates a group attribute.
- `"group.PropertyValue"`

**Example**

```plaintext
"group.PropertyName","group.PropertyValue"
"Flight", "Frankfurt - Paris €299"
"Hotel", "SuperFrenchLuxuryHotelChain"
"Destination", "Paris"
```

---

### Procedure

1. Go to *Administration > Attributes > Group Attributes*.
2. Select the desired group.
3. Expand the **More Options** drop-down and click **Import**.
4. Upload the file using the file picker.
5. Select the file type (CSV or XML).
6. Specify the character set.
7. Choose the desired import mode.
8. (For CSV files) Enter the separator under **Advanced Options** (default: comma).
9. Click **Upload** to begin the import.
  - A report on the import will appear in the **Group Attributes** window.
  - Successfully imported attributes will be displayed.

---

## Exporting Group Attributes

You can export a group attribute as a CSV file.

1. Go to *Administration > Attributes > Group Attributes*.
2. Select the group.
3. Expand the **More Options** drop-down list.
4. Click **Export**.

![Mapp Engage interface showing group attributes with options to export and import data.](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/exp att.PNG)
  - The export starts immediately.
  - When the export process is complete, you receive an email with a link to download the file.
  - The exported file is available via this link for 7 days.

---

## Deleting Group Attributes

1. Navigate to *Administration > Attributes > Group Attributes*.
2. Select the required group from the drop-down list.
3. Activate the checkbox next to the attribute you want to delete.
4. Click **Delete** at the bottom of the page.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image-S319LUUU.png)