API Reference / API Methods / Settings / Set settings
Feb. 26, 2019

Set settings

Required API Key: any key with the editSettings ACL
Method signature
$index->setSettings(array settings)

$index->setSettings(array settings, [
  // All the following parameters are optional
  'forwardToReplicas' => bool
])

About this method

Create or change an index’s settings.

Only specified settings are overridden; unspecified settings are left unchanged. Specifying null for a setting resets it to its default value.

The supported settings are listed in the Settings Parameters page.

Performance wise, it’s better to set settings before pushing the data.

Examples

Simple set settings

1
2
3
4
5
$index->setSettings(
  [
    'customRanking' => ['desc(followers)']
  ]
);

Set setting and forward to replicas

1
2
3
4
5
6
7
8
9
10
11
$forwardToReplicas = true;

$index->setSettings(
  [
    'searchableAttributes' => ['name', 'address'],
    'customRanking' => ['desc(followers)'],
  ],
  [
    'forwardToReplicas' => $forwardToReplicas
  ]
);

Parameters

settings
type: key value mapping
Required

A mapping of settings parameters you can use on an index.

forwardToReplicas
type: boolean
default: false
Optional

Whether to forward the same settings to the replica indices.

Response

In this section we document the JSON response returned by the API. Each language will encapsulate this response inside objects specific to the language and/or the implementation. So the actual type in your language might differ from what is documented.

JSON format

1
2
3
4
{
  "updatedAt":"2013-01-18T15:33:13.556Z",
  "taskID": 678
}
updatedAt
string

Date at which the indexing job has been created.

taskID
integer

The taskID used with the waitTask method.

Did you find this page helpful?