<!-- Source: https://docs.squirro.com/en/latest/technical/communities/auto-subscription.html -->
# Community Auto-Subscription

Profile: Project Creator

This page describes the community auto-subscription feature and how it can be configured by project creators within the Sales Insights application.

This feature is Squirro Sales Insights feature designed for integration with CRMs. It is not designed for Cognitive Search projects.

> **Note**
>
> It is possible to configure auto-subscription within any project type with a structured relationship between the owner and community within items. If you are not using Sales Insights and need help structuring this, visit the [Squirro Support website](https://go.squirro.com/support) and submit a technical support request.

## Overview

Squirro offers the ability to automatically subscribe users to specific communities within Sales Insights. This allows you to automatically follow the communities you own or manage rather than having to subscribe manually.

In the context of Sales Insights, Squirro defines an owner as a user responsible for an account.

An account is conceptualized as a community in a Squirro project. If this relationship is ingested into Squirro, you can monitor assigned accounts automatically. The auto-subscription works continuously, so you’ll automatically follow newly ingested accounts as they’re added.

## Configuring Auto-Subscription

To configure Community Auto-Subscription, follow the steps below:

1. Log in to your Squirro Sales Insights project.
2. Navigate to **Setup → Settings**.
3. Click **Project Configuration** from the left menu.
4. Locate `topic.community.auto-subscription` as shown in the screen clip below:

[![Dashboards Edit Page Left Section](https://s3.amazonaws.com/download.squirro.net/docs/technical/communities/comm-config.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/communities/comm-config.png)

## Configuration Values

The configuration is stored in the `topic.community.auto-subscription` key, which expects a dictionary containing certain fields as its value.

[![Dashboards Edit Page Left Section](https://s3.amazonaws.com/download.squirro.net/docs/technical/communities/config-comm-auto.png)](https://s3.amazonaws.com/download.squirro.net/docs/technical/communities/config-comm-auto.png)

The config value expects four fields:

- `account_owner_identifier_facet`
- `filter_query`
- `community_type_facet`
- `user_identifier_key`

### account_owner_identifier_facet

Contains information about an owner in the Squirro data schema. The default is set to `owner`, since, in Sales Insights, the owner information is stored in the `owner` label.

### filter_query

Query used to filter the data down to items that contain both the `owner` and the `account` fields. The default is set to `item_type:Account`.

### community_type_facet

Contains the communities that the user will auto-subscribe to. The default is set to `account_name`, since, in Sales Insights, all the company-based communities are stored in a community type based on the `account_name` label.

### user_identifier_key

Field used to uniquely identify a user in the database that also maps to the `account_owner_identifier_facet` value. Typical choices would be name or email address. The default is set to `full_name`, since the `account_owner_identifier_facet` is set to `owner` which contains the full name of the user.

Once the configuration is set, the auto-subscription process runs automatically each time new communities are added.
