Skip to content

Activity Settings

Config key: settings.activitySettings

Irreversible

Once applied, allowUsersToRelateMultipleContactsToTasksAndEvents cannot be changed back.

Setup: Feature Settings → Sales → Activity Settings (/lightning/setup/HomeActivitiesSetupPage/home)

Although the Metadata API has an ActivitiesSettings.allowUsersToRelateMultipleContactsToTasksAndEvents field, it is read-only since API v36.0: the setting cannot be enabled through an API.

Screenshot

Activity Settings

Pill Field
1 allowUsersToRelateMultipleContactsToTasksAndEvents

Use cases

Meetings are logged once for every contact who attended

The account managers of Proseware meet buying committees of four or five people. An event can only be related to one contact, so they either log the meeting once and the other attendees show no activity, or log it five times and the activity reports count five meetings.

Allow Users to Relate Multiple Contacts to Tasks and Events turns on Shared Activities: a task or an event can name up to 50 contacts. The ActivitiesSettings field of the Metadata API is read-only, so the setting can only be turned on in Setup, and only Salesforce Support can turn it off again: try it in a sandbox before applying this config to production.

{
  "$schema": "https://raw.githubusercontent.com/amtrack/sfdx-browserforce-plugin/main/src/plugins/schema.json",
  "settings": {
    "activitySettings": {
      "allowUsersToRelateMultipleContactsToTasksAndEvents": true
    }
  }
}

Fields

Field Type Description
allowUsersToRelateMultipleContactsToTasksAndEvents boolean Allow Users to Relate Multiple Contacts to Tasks and Events
Although the Metadata API has a ActivitiesSettings.allowUsersToRelateMultipleContactsToTasksAndEvents field, it is not possible to enable this setting using an API. Warning: can only be disabled with help of the salesforce.com Support team. https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_activitiessettings.htm
Irreversible: cannot be changed back once applied.
JSON Schema
{
  "type": "object",
  "properties": {
    "allowUsersToRelateMultipleContactsToTasksAndEvents": {
      "type": "boolean",
      "title": "Allow Users to Relate Multiple Contacts to Tasks and Events",
      "x-irreversible": true,
      "description": "Although the Metadata API has a ActivitiesSettings.allowUsersToRelateMultipleContactsToTasksAndEvents field, it is not possible to enable this setting using an API. Warning: can only be disabled with help of the salesforce.com Support team. https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_activitiessettings.htm"
    }
  },
  "title": "Activity Settings",
  "description": "Setup: **Feature Settings → Sales → Activity Settings** (`/lightning/setup/HomeActivitiesSetupPage/home`)\n\nAlthough the Metadata API has an `ActivitiesSettings.allowUsersToRelateMultipleContactsToTasksAndEvents` field, it is read-only since API v36.0: the setting cannot be enabled through an API.\n\n![Activity Settings](https://raw.githubusercontent.com/amtrack/sfdx-browserforce-plugin/main/src/plugins/activity-settings/screenshot.webp)",
  "examples": [
    {
      "allowUsersToRelateMultipleContactsToTasksAndEvents": true
    }
  ]
}

Source code of this setting