Incremental updates

After your initial upload, keep your up to date with incremental updates. Track additions, changes, and deletions in your data source, then apply them to the corresponding in Algolia.

Track each record with a unique identifier

Incremental updates rely on the objectID attribute to match your source data to the right record. Derive each record’s objectID from the source item’s unique identifier and keep it stable. Changing the objectID can create a second record instead of updating the existing one. For more information, see Unique record identifiers.

Choose how to send updates

Use a connector to schedule updates from a supported source, such as a database or a hosted JSON or CSV file. To send updates from your own code, use the API methods in the following sections. If you want Algolia to transform records before indexing them, use Push to Algolia instead of calling the Search API directly.

Add records

When you add data to your source, use the saveObjects method to send the corresponding records to Algolia. To run the code examples on this page, install the latest API client.

List<BatchResponse> response = await client.SaveObjectsAsync(
  "INDEX_NAME",
  new List<Object>
  {
    new Dictionary<string, string> { { "objectID", "1" }, { "name", "Adam" } },
    new Dictionary<string, string> { { "objectID", "2" }, { "name", "Benoit" } },
  }
);

response, err := client.SaveObjects(
  "INDEX_NAME",
  []map[string]any{{"objectID": "1", "name": "Adam"}, {"objectID": "2", "name": "Benoit"}})
if err != nil {
  // handle the eventual error
  panic(err)
}

// response is a slice of search.BatchResponse

List<BatchResponse> response = client.saveObjects(
  "INDEX_NAME",
  Arrays.asList(
    new HashMap() {
      {
        put("objectID", "1");
        put("name", "Adam");
      }
    },
    new HashMap() {
      {
        put("objectID", "2");
        put("name", "Benoit");
      }
    }
  )
);

const response: BatchResponse[] = await client.saveObjects({
  indexName: 'cts_e2e_saveObjects_javascript',
  objects: [
    { objectID: '1', name: 'Adam' },
    { objectID: '2', name: 'Benoit' },
  ],
});

var response: List<BatchResponse> =
  client.saveObjects(
    indexName = "INDEX_NAME",
    objects =
      listOf(
        buildJsonObject {
          put("objectID", JsonPrimitive("1"))
          put("name", JsonPrimitive("Adam"))
        },
        buildJsonObject {
          put("objectID", JsonPrimitive("2"))
          put("name", JsonPrimitive("Benoit"))
        },
      ),
  )

/** @var array<BatchResponse> $response */
$response = $client->saveObjects(
    'INDEX_NAME',
    [
        ['objectID' => '1',
            'name' => 'Adam',
        ],

        ['objectID' => '2',
            'name' => 'Benoit',
        ],
    ],
);

response: list[BatchResponse] = client.save_objects(
    index_name="INDEX_NAME",
    objects=[
        {
            "objectID": "1",
            "name": "Adam",
        },
        {
            "objectID": "2",
            "name": "Benoit",
        },
    ],
)

response = client.save_objects(
  "INDEX_NAME",
  [{objectID: "1", name: "Adam"}, {objectID: "2", name: "Benoit"}]
)
# response is an array of BatchResponse objects

val response: Seq[BatchResponse] = Await.result(
  client.saveObjects(
    indexName = "INDEX_NAME",
    objects = Seq(
      JObject(List(JField("objectID", JString("1")), JField("name", JString("Adam")))),
      JObject(List(JField("objectID", JString("2")), JField("name", JString("Benoit"))))
    )
  ),
  Duration(100, "sec")
)

let response: [BatchResponse] = try await client.saveObjects(
    indexName: "INDEX_NAME",
    objects: [["objectID": "1", "name": "Adam"], ["objectID": "2", "name": "Benoit"]]
)

Update records

You can update records in two ways:

Replace the entire record
Update specific attributes

Replace old records

To replace an existing record, use saveObjects with its objectID and the complete updated record. Algolia replaces the entire record, removing any existing attributes you omit. Use full record updates when your system can send the complete record, even if you don’t know which attributes changed.

List<BatchResponse> response = await client.SaveObjectsAsync(
  "INDEX_NAME",
  new List<Object>
  {
    new Dictionary<string, string> { { "objectID", "1" }, { "name", "Adam" } },
    new Dictionary<string, string> { { "objectID", "2" }, { "name", "Benoit" } },
  }
);

response, err := client.SaveObjects(
  "INDEX_NAME",
  []map[string]any{{"objectID": "1", "name": "Adam"}, {"objectID": "2", "name": "Benoit"}})
if err != nil {
  // handle the eventual error
  panic(err)
}

// response is a slice of search.BatchResponse

List<BatchResponse> response = client.saveObjects(
  "INDEX_NAME",
  Arrays.asList(
    new HashMap() {
      {
        put("objectID", "1");
        put("name", "Adam");
      }
    },
    new HashMap() {
      {
        put("objectID", "2");
        put("name", "Benoit");
      }
    }
  )
);

const response: BatchResponse[] = await client.saveObjects({
  indexName: 'cts_e2e_saveObjects_javascript',
  objects: [
    { objectID: '1', name: 'Adam' },
    { objectID: '2', name: 'Benoit' },
  ],
});

var response: List<BatchResponse> =
  client.saveObjects(
    indexName = "INDEX_NAME",
    objects =
      listOf(
        buildJsonObject {
          put("objectID", JsonPrimitive("1"))
          put("name", JsonPrimitive("Adam"))
        },
        buildJsonObject {
          put("objectID", JsonPrimitive("2"))
          put("name", JsonPrimitive("Benoit"))
        },
      ),
  )

/** @var array<BatchResponse> $response */
$response = $client->saveObjects(
    'INDEX_NAME',
    [
        ['objectID' => '1',
            'name' => 'Adam',
        ],

        ['objectID' => '2',
            'name' => 'Benoit',
        ],
    ],
);

response: list[BatchResponse] = client.save_objects(
    index_name="INDEX_NAME",
    objects=[
        {
            "objectID": "1",
            "name": "Adam",
        },
        {
            "objectID": "2",
            "name": "Benoit",
        },
    ],
)

response = client.save_objects(
  "INDEX_NAME",
  [{objectID: "1", name: "Adam"}, {objectID: "2", name: "Benoit"}]
)
# response is an array of BatchResponse objects

val response: Seq[BatchResponse] = Await.result(
  client.saveObjects(
    indexName = "INDEX_NAME",
    objects = Seq(
      JObject(List(JField("objectID", JString("1")), JField("name", JString("Adam")))),
      JObject(List(JField("objectID", JString("2")), JField("name", JString("Benoit"))))
    )
  ),
  Duration(100, "sec")
)

let response: [BatchResponse] = try await client.saveObjects(
    indexName: "INDEX_NAME",
    objects: [["objectID": "1", "name": "Adam"], ["objectID": "2", "name": "Benoit"]]
)

Update a subset of the record

Partial updates let you change specific attributes without sending the complete record. This is useful when different systems manage different attributes of the same record. Use the partialUpdateObjects method and pass each record’s objectID with the attributes to update. Other attributes in the record remain unchanged. If an attribute you update contains a JSON object, include every value you want to keep in that object. Algolia replaces the object rather than merging its contents. The following example sets createIfNotExists to true, so Algolia creates a record if the specified objectID doesn’t exist.

List<BatchResponse> response = await client.PartialUpdateObjectsAsync(
  "INDEX_NAME",
  new List<Object>
  {
    new Dictionary<string, string> { { "objectID", "1" }, { "name", "Adam" } },
    new Dictionary<string, string> { { "objectID", "2" }, { "name", "Benoit" } },
  },
  true
);

response, err := client.PartialUpdateObjects(
  "INDEX_NAME",
  []map[string]any{{"objectID": "1", "name": "Adam"}, {"objectID": "2", "name": "Benoit"}}, search.WithCreateIfNotExists(true))
if err != nil {
  // handle the eventual error
  panic(err)
}

// response is a slice of search.BatchResponse

List<BatchResponse> response = client.partialUpdateObjects(
  "INDEX_NAME",
  Arrays.asList(
    new HashMap() {
      {
        put("objectID", "1");
        put("name", "Adam");
      }
    },
    new HashMap() {
      {
        put("objectID", "2");
        put("name", "Benoit");
      }
    }
  ),
  true
);

const response: BatchResponse[] = await client.partialUpdateObjects({
  indexName: 'cts_e2e_partialUpdateObjects_javascript',
  objects: [
    { objectID: '1', name: 'Adam' },
    { objectID: '2', name: 'Benoit' },
  ],
  createIfNotExists: true,
});

var response: List<BatchResponse> =
  client.partialUpdateObjects(
    indexName = "INDEX_NAME",
    objects =
      listOf(
        buildJsonObject {
          put("objectID", JsonPrimitive("1"))
          put("name", JsonPrimitive("Adam"))
        },
        buildJsonObject {
          put("objectID", JsonPrimitive("2"))
          put("name", JsonPrimitive("Benoit"))
        },
      ),
    createIfNotExists = true,
  )

/** @var array<BatchResponse> $response */
$response = $client->partialUpdateObjects(
    'INDEX_NAME',
    [
        ['objectID' => '1',
            'name' => 'Adam',
        ],

        ['objectID' => '2',
            'name' => 'Benoit',
        ],
    ],
    true,
);

response: list[BatchResponse] = client.partial_update_objects(
    index_name="INDEX_NAME",
    objects=[
        {
            "objectID": "1",
            "name": "Adam",
        },
        {
            "objectID": "2",
            "name": "Benoit",
        },
    ],
    create_if_not_exists=True,
)

response = client.partial_update_objects(
  "INDEX_NAME",
  [{objectID: "1", name: "Adam"}, {objectID: "2", name: "Benoit"}],
  true
)
# response is an array of BatchResponse objects

val response: Seq[BatchResponse] = Await.result(
  client.partialUpdateObjects(
    indexName = "INDEX_NAME",
    objects = Seq(
      JObject(List(JField("objectID", JString("1")), JField("name", JString("Adam")))),
      JObject(List(JField("objectID", JString("2")), JField("name", JString("Benoit"))))
    ),
    createIfNotExists = true
  ),
  Duration(100, "sec")
)

let response: [BatchResponse] = try await client.partialUpdateObjects(
    indexName: "INDEX_NAME",
    objects: [["objectID": "1", "name": "Adam"], ["objectID": "2", "name": "Benoit"]],
    createIfNotExists: true
)

Delete records

Whenever you delete data in your data source, you can delete the corresponding record from Algolia with deleteObjects.

List<BatchResponse> response = await client.DeleteObjectsAsync(
  "INDEX_NAME",
  new List<string> { "1", "2" }
);

response, err := client.DeleteObjects(
  "INDEX_NAME",
  []string{"1", "2"})
if err != nil {
  // handle the eventual error
  panic(err)
}

// response is a slice of search.BatchResponse

List<BatchResponse> response = client.deleteObjects("INDEX_NAME", Arrays.asList("1", "2"));

const response: BatchResponse[] = await client.deleteObjects({
  indexName: 'INDEX_NAME',
  objectIDs: ['1', '2'],
});

var response: List<BatchResponse> =
  client.deleteObjects(indexName = "INDEX_NAME", objectIDs = listOf("1", "2"))

/** @var array<BatchResponse> $response */
$response = $client->deleteObjects(
    'INDEX_NAME',
    [
        '1',

        '2',
    ],
);

response: list[BatchResponse] = client.delete_objects(
    index_name="INDEX_NAME",
    object_ids=[
        "1",
        "2",
    ],
)

response = client.delete_objects("INDEX_NAME", ["1", "2"])
# response is an array of BatchResponse objects

val response: Seq[BatchResponse] = Await.result(
  client.deleteObjects(
    indexName = "INDEX_NAME",
    objectIDs = Seq("1", "2")
  ),
  Duration(100, "sec")
)

let response: [BatchResponse] = try await client.deleteObjects(
    indexName: "INDEX_NAME",
    objectIDs: ["1", "2"]
)

Delete by query

To delete records that match an attribute value, use the deleteBy method. Specify the condition in the request’s filters parameter. For example, brand:brandName deletes all records whose brand attribute is brandName. To filter on the brand string attribute, add it to your index’s attributesForFaceting.

var response = await client.DeleteByAsync(
  "INDEX_NAME",
  new DeleteByParams { Filters = "brand:brandName" }
);

final response = await client.deleteBy(
  indexName: "INDEX_NAME",
  deleteByParams: DeleteByParams(
    filters: "brand:brandName",
  ),
);

response, err := client.DeleteBy(client.NewApiDeleteByRequest(
  "INDEX_NAME",
  search.NewEmptyDeleteByParams().SetFilters("brand:brandName")))
if err != nil {
  // handle the eventual error
  panic(err)
}

UpdatedAtResponse response = client.deleteBy("INDEX_NAME", new DeleteByParams().setFilters("brand:brandName"));

const response = await client.deleteBy({ indexName: 'theIndexName', deleteByParams: { filters: 'brand:brandName' } });

var response =
  client.deleteBy(
    indexName = "INDEX_NAME",
    deleteByParams = DeleteByParams(filters = "brand:brandName"),
  )

$response = $client->deleteBy(
    'INDEX_NAME',
    ['filters' => 'brand:brandName',
    ],
);

response = client.delete_by(
    index_name="INDEX_NAME",
    delete_by_params={
        "filters": "brand:brandName",
    },
)

response = client.delete_by("INDEX_NAME", Algolia::Search::DeleteByParams.new(filters: "brand:brandName"))

val response = Await.result(
  client.deleteBy(
    indexName = "INDEX_NAME",
    deleteByParams = DeleteByParams(
      filters = Some("brand:brandName")
    )
  ),
  Duration(100, "sec")
)

let response = try await client.deleteBy(
    indexName: "INDEX_NAME",
    deleteByParams: DeleteByParams(filters: "brand:brandName")
)

deleteBy is resource-intensive. If you know the records’ object IDs, use deleteObjects for better performance.

Manage individual records in the dashboard

For one-off changes, you can add, edit, or delete single records in the Algolia dashboard without writing code.

Go to the Algolia dashboard and select your Algolia .
On the left sidebar, select Search.
Select your Algolia index.
Do one of the following:
- To add records, select Add records > Add manually. Paste your records in JSON format, then click Save.
- To edit a record, find it in the Browse tab, click Edit record, change the JSON, then click Edit.
- To delete a record, find it in the Browse tab and click Delete record, then click Delete.

To import a file instead, see Import from the dashboard.

Search and Discovery platform

Optimization and Personalization

AI-powered experiences

Production and scale

Incremental updates

Track each record with a unique identifier

Choose how to send updates

Add records

Update records

Replace old records

Update a subset of the record

Delete records

Delete by query

Manage individual records in the dashboard

​Track each record with a unique identifier

​Choose how to send updates

​Add records

​Update records

​Replace old records

​Update a subset of the record

​Delete records

​Delete by query

​Manage individual records in the dashboard

Track each record with a unique identifier

Choose how to send updates

Add records

Update records

Replace old records

Update a subset of the record

Delete records

Delete by query

Manage individual records in the dashboard