---
title: SharePoint Online source JSON modification
slug: o2f80147
canonical_url: https://docs.coveo.com/en/o2f80147/
collection: index-content
source_format: adoc
---
# SharePoint Online source JSON modification
Many [source](https://docs.coveo.com/en/246/) configuration parameters can be set through the user interface.
Others, such as rarely used or new parameters, must be configured in the **Edit configuration with JSON** panel.
To access this panel from the [**Sources**](https://platform.cloud.coveo.com/admin/#/orgid/content/sources/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/content/sources/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/content/sources/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/content/sources/)) page, click the source, and then click **Edit configuration with JSON** in the **More** menu.

This article explains how to configure SharePoint Online source parameters, whether they're already listed in the JSON or not.

## Configuring listed and unlisted parameters

[float-group]
--
![Changing a parameter value in the source JSON configuration | Coveo](https://docs.coveo.com/en/assets/images/index-content/changing-parameter-values.gif)
If the parameter you want to change is already listed in the `parameters` section of the source JSON configuration, just modify its `value` in the JSON configuration.

If the parameter isn't listed in the `parameters` section, copy the entire parameter example object from the [Reference](#reference) section below and paste it into that section.
Then, update the `value` in the JSON configuration, if necessary.
--

> **Important**
>
> If a parameter has a `value` attribute that contains sensitive information, set the `sensitive` attribute to `true`.
> Otherwise, the value will appear in clear text in the JSON configuration.

> **Tip**
>
> Document the changes you make to the source JSON configuration in the **Comments** area below the JSON configuration.
> This ensures that you can easily revert to a previous configuration if needed.

## Reference

This section provides information on the SharePoint Online source parameters that you can only modify through the JSON configuration.

If a JSON configuration parameter isn't documented in this article, configure it through the source edition panel instead.

### `AllowedDeletionPercentage` (Integer)

This parameter specifies the maximum allowed percentage of [source](https://docs.coveo.com/en/246/) [items](https://docs.coveo.com/en/210/) that can be deleted from the index at the end of a [rescan](https://docs.coveo.com/en/2711/).
If the actual percentage of source items to delete exceeds this value, no items are deleted from the index.
By default, this parameter is set to `100`, which means that all source items can be deleted.

The purpose of this parameter is to prevent accidental mass item deletions.
This can occur, for example, because of an improper source configuration or if the content to index was moved.

For more information about this parameter and its usage, see [Forbid item deletion based on a percentage condition](https://docs.coveo.com/en/2006#forbid-item-deletion-based-on-a-percentage-condition).

**Example**

You can set `AllowedDeletionPercentage` to `10` in the JSON configuration of your source, as shown in the snippet below.
With this configuration, if Coveo detects that more than 10% of the items are flagged for deletion during a rescan, deletion will be blocked.
The status on the [**Sources**](https://platform.cloud.coveo.com/admin/#/orgid/content/sources/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/content/sources/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/content/sources/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/content/sources/)) page will show your source in error, and the error details will indicate the actual percentage of items that were flagged for deletion versus the allowed percentage (in this case, 10%).

```json
"AllowedDeletionPercentage": {
  "sensitive": false,
  "value": "10"
}
```

### `BatchSize` (Integer)

Specifies the number of items to retrieve with each request to SharePoint Online.
The default value is `100` and the maximum value is `1000`.

**Example**

```json
"BatchSize": {
  "sensitive": false,
  "value": "200"
}
```

> **Note**
>
> Batching parameter default values are based on testing by the Coveo development team.
> We recommend you contact [Coveo Support](https://connect.coveo.com/s/case/Case/Default) before changing the value of this parameter.

### `GroupMembersBatchSize` (Integer)

Specifies the number of group members to retrieve with each request to SharePoint Online.
The default value is `100` and the maximum value is `1000`.

**Example**

```json
"GroupMembersBatchSize": {
  "sensitive": false,
  "value": "200"
}
```

> **Note**
>
> Batching parameter default values are based on testing by the Coveo development team.
> We recommend you contact [Coveo Support](https://connect.coveo.com/s/case/Case/Default) before changing the value of this parameter.

### `IndexOnlyTeamSites` (Boolean)

Specifies whether to index only SharePoint Team sites.
The default value is `false`.

**Example**

```json
"IndexOnlyTeamSites": {
  "sensitive": false,
  "value": "true"
}
```

### `NumberOfRetries` (Integer)

Specifies the maximum number of times a failing API request will be retried.
The default value is `5` and the maximum value is `25`.

**Example**

```json
"NumberOfRetries": {
  "sensitive": false,
  "value": "5"
}
```

### `OnlyIndexSitesWithCoveoProperty` (String | Null)

Specifies the value that the `CoveoSiteFilter` managed property must be set to for the site to be [indexed](https://docs.coveo.com/en/204/).
The default value is `null`, which means that the site `CoveoSiteFilter` managed property value isn't considered to determine if the site should be [indexed](https://docs.coveo.com/en/204/).

**Example**

The following configuration would only index sites whose `CoveoSiteFilter` managed property value is set to `Canada`.

```json
"OnlyIndexSitesWithCoveoProperty": {
  "sensitive": false,
  "value": "Canada"
}
```

See [Tag sites with the CoveoSiteFilter managed property](https://docs.coveo.com/en/naoe0288/) for more information.

### `RecrawlListFolderContentOnChange` (Boolean)

Specifies whether to recrawl all items in a list folder that has changed.
The default value is `false`.

This setting was created to handle cases where a list folder is marked as modified (not the items in the folder) and the items in the folder should be [recrawled](https://docs.coveo.com/en/2121/) to reflect the changes.
This can happen, for example, when items inherit permissions from the folder and the folder permissions have been changed.

**Example**

```json
"RecrawlListFolderContentOnChange": {
  "sensitive": false,
  "value": "false"
}
```

> **Important**
>
> Setting this parameter to `true` can have a significant impact on the number of items that are [recrawled](https://docs.coveo.com/en/2121/) and [indexing](https://docs.coveo.com/en/204/) performance.
> See [Postpone reindexing changes to list folder content](https://docs.coveo.com/en/n8ub0545#postpone-reindexing-changes-to-list-folder-content) for more information.

### `RequestTimeout` (Integer)

Specifies the maximum amount of time, in seconds, that a request can execute before being canceled.
The default value is `60` and the maximum value is `900`.

**Example**

```json
"RequestTimeout": {
  "sensitive": false,
  "value": "60"
}
```

### `UserProfileBatchSize` (Integer)

Specifies the number of user profiles to retrieve with each request to SharePoint Online.
The default value is `100` and the maximum value is `999`.

**Example**

```json
"UserProfileBatchSize": {
  "sensitive": false,
  "value": "100"
}
```

> **Note**
>
> Batching parameter default values are based on testing by the Coveo development team.
> We recommend you contact [Coveo Support](https://connect.coveo.com/s/case/Case/Default) before changing the value of this parameter.