---
title: Adding custom activity types
related:
  - https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/tracking-contact-activities/reference-activity-types.md
  - https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/tracking-contact-activities/manually-logging-custom-activities.md
  - https://docs.kentico.com/13/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-activities/logging-custom-activities-through-the-api.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

> **Info:** **Enterprise license required**
>
> Features described on this page require the **Kentico Xperience Enterprise** license.

In addition to the [default activity types](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/tracking-contact-activities/reference-activity-types.md), you can also define custom activity types for tracking any other actions.

> **Note:** **Note**
>
> Only users with the global administrator [privilege level](https://docs.kentico.com/13/managing-users/user-management.md) can define custom activity types.

To add custom activity types:

1. Open the **Contact management** application.
2. Switch to the **Configuration -> Activity** **types** tab.
3. Click **New activity type**.
4. Fill in the following fields as required:

   | Display name          | The name of the activity type used in the administration interface.                                                                                                                                     |
   | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Code name             | Serves as a unique identifier for the activity type (for example in the API).<br>You can leave the _(automatic)_ option to have the system generate an appropriate code name based on the display name. |
   | Description           | Text description about the purpose of the activity type.                                                                                                                                                |
   | Allow manual creation | If you enable this option, users with access to the on-line marketing administration interface are allowed to manually log activities of this custom type.                                              |
   | Enabled               | Indicates whether the system logs activities of this type.                                                                                                                                              |
   | Activity type color   | Indicates the highlight color used for the activity type in a list of activities.                                                                                                                       |
5. (Optional) Set the **Activity item** **control** and **Activity detail control** field options in the **Scoring rule configuration** section.

   - The system offers the _Activity item_ and _Activity detail_ fields when defining [scoring rules](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/scoring-contacts.md) based on the custom activity.
   - For example, an activity type representing testimonials has an _SKU selector_ item control. This allows the score administrators to create different scoring rules for testimonials related to different products.
   - The _(none)_ value hides the given field when creating scoring rules based on the custom activity.
   - The _(default)_ value provides standard comparison options for text and numeric values.

   ![Creating a custom activity type](https://docs.kentico.com/docsassets/13/adding-custom-activity-types/creating_custom_activity.png "Creating a custom activity type")
6. Click **Save**.

Your custom activity type is now ready. You can either log the custom activities [manually](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/tracking-contact-activities/manually-logging-custom-activities.md) in the user interface or set up the system to log them automatically [through the API](https://docs.kentico.com/13/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-activities/logging-custom-activities-through-the-api.md) or via the [Log custom activity](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/marketing-automation/working-with-the-automation-process-designer/adding-marketing-actions-to-automation-processes.md) marketing automation step.