# DistributeByFields

Set `DistributeByFields` to `True` to index data based on the value of a specified field in the documents being indexed or in which the field is replaced.

This option is similar to reference-based indexing, except that you configure the fields to extract from the document to determine which child server to send the document to. This option applies to DREADD, DREADDDATA and DREREPLACE index actions. You configure the field to use with the DistributeByFieldsCSVs configuration parameter.

If enabled, the DIH is restricted so that you cannot alter the number of child servers.

When `DistributeByFields` is set to `True`, DIH consistently distributes documents according to the field. If a child server goes down, it queues the documents for that child server, and indexes them when the server becomes available. Unlike simple non-mirror mode, it does not redistribute the documents to available servers.

NOTE: You can use this distribution mode only when MirrorMode is set to `False`. DIH will not start if you attempt to configure this distribution mode when MirrorMode is set to `True`.

Type: | Boolean
Default: | False
Required: | No
Configuration Section: | Server
Example: | `DistributeByFields=True`
See Also: | BalanceDistributeByFields DistributeByFieldsCSVs DistributeByFieldsValues MirrorMode

_FT_HTML5_bannerTitle.htm