hitsPerPage

Type: integer

Engine default: 20

Parameter syntax

'hitsPerPage' => number_of_hits

hitsPerPage: number_of_hits

hitsPerPage: number_of_hits

'hitsPerPage': number_of_hits

hitsPerPage = number_of_hits

hitsPerPage: Int = number_of_hits

IndexSettings settings = new IndexSettings();
settings.HitsPerPage = number_of_hits;

.setHitsPerPage(number_of_hits)

opt.HitsPerPage(number_of_hits)

hitsPerPage = Some(number_of_hits)

Can be used in these methods:
search, setSettings, browseObjects, generateSecuredApiKey, addApiKey, updateApiKey search, set_settings, browse_objects, generate_secured_api_key, add_api_key, update_api_key search, setSettings, browseObjects, generateSecuredApiKey, addApiKey, updateApiKey search, set_settings, browse_objects, generate_secured_api_key, add_api_key, update_api_key search, setSettings, browse, generateSecuredApiKey, addAPIKey, updateAPIKey search, setSettings, browseObjects, generateSecuredApiKey, addApiKey, updateApiKey Search, SetSettings, Browse, GenerateSecuredApiKeys, AddApiKey, UpdateApiKey Search, setSettings, browse, generateSecuredApiKey, addApiKey, updateApiKey Search, SetSettings, BrowseObjects, GenerateSecuredAPIKey, AddAPIKey, UpdateAPIKey search, setSettings, browse index, generateSecuredApiKey, add key, update key

See code examples

About this parameter

Set the number of hits per page for paginating the search results.

Algolia uses the page and hitsPerPage parameters to control how search results are displayed (paginated).

hitsPerPage: sets the number of search results (hits) displayed per page. Choose a value between 1 and 1,000. The default is 20.
page: specifies the page number of the search results you want to retrieve. Page numbering starts at 0, so the first page is page=0, the second is page=1, and so on.

For example, to display 10 results per page starting from the third page, set hitsPerPage to 10 and page to 2.

Usage notes

This is set at indexing time.
Setting can be overridden at query time.

Examples

Set default number of hits per page

Copy

1
2
3
$index->setSettings([
  'hitsPerPage' => 20
]);

1
2
3
4
5
6
7
8
let settings = Settings()
  .set(\.hitsPerPage, to: 20)

index.setSettings(settings) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

Override default number of hits per page for the current search