Algolia integration to elixir application

Latest version: 0.7.1 registry icon
Maintenance score
Safety score
Popularity score
Check your open source dependency risks. Get immediate insight about security, stability and licensing risks.
Version Suggest Low Medium High
0.7.1 0 0 0 0
0.7.0 0 0 0 0
0.6.0 0 0 0 0
0.5.0 0 0 0 0
0.4.3 0 0 0 0
0.4.2 0 0 0 0
0.4.1 0 0 0 0
0.4.0 0 0 0 0
0.3.0 0 0 0 0
0.2.0 0 0 0 0

Latest release:

0.7.1 - this version is safe to use because it has no known security vulnerabilities at this time. Find out if your coding project uses this component and get notified of any reported security vulnerabilities with Meterian-X Open Source Security Platform


Maintain your licence declarations and avoid unwanted licences to protect your IP the way you intended.

BSD-2-Clause   -   BSD 2-Clause "Simplified" License

Not a wildcard

Not proprietary

OSI Compliant


CircleCI Module Version Hex Docs Total Download License Last Updated

This package let you easily integrate Algolia to your Elixir application. It can be used with built in Elixir struct or with Ecto schemas.


The package can be installed by adding :algoliax to your list of dependencies in mix.exs:

def deps do
    {:algoliax, "~> 0.7.0"}

If using with Ecto schemas, Algoliax requires :ecto.


Algoliax needs only :api_key and :application_id config. These configs can either be on config files or using environment variables ALGOLIA_API_KEY and ALGOLIA_APPLICATION_ID.

config :algoliax,
  api_key: "<API_KEY>",
  application_id: "<APPLICATION_ID>",
  batch_size: 500,
  recv_timeout: 5000


defmodule People do
  use Algoliax.Indexer,
    index_name: :algoliax_people,
    object_id: :reference,
    algolia: [
      attributes_for_faceting: ["age"],
      searchable_attributes: ["full_name"],
      custom_ranking: ["desc(updated_at)"]

  defstruct reference: nil, last_name: nil, first_name: nil, age: nil

Overridable functions:

  • to_be_indexed/1 which take the model struct in parameter: allows to choose to index or not the current model
defmodule People do

  @impl Algoliax
  def to_be_indexed?(person) do
    person.age > 20

# This object will be indexed
people1 = %People{reference: 10, last_name: "Doe", first_name: "John", age: 13}

# This object will not be indexed
people2 = %People{reference: 87, last_name: "Fred", first_name: "Al", age: 70}
  • build_object/1 which take the model struct/map in parameter and should return a Map: allow to add attributes to the indexed object. By default the object contains only an ObjectID.
defmodule People do

  @impl Algoliax
  def build_object(person) do
      age: person.age,
      now: Date.utc_today()

Index name at runtime

It's possible to define an index name at runtime, useful if index_name depends on environment or comes from an environment variable.

To do this just define a function with an arity of 0 that will be used as index_name

defmodule People do
  use Algoliax.Indexer,
    index_name: :algoliax_people,
    object_id: :reference,
    algolia: [...]

  def algoliax_people do

Index functions

# Get people index settings

# Delete index

# Configure index

Object functions

# Save object

# Save multiple objects
People.save_objects([people1, people2])

# Save multiple objects, and ensure object that they can't be indexed anymore are deleted from the index
People.save_objects([people1, people2], force_delete: true)

# Get object

# Delete object

Search functions

# search in index"john")

# search facet

Ecto specific

First you will need to add the Repo to the algoliax config:

use Algoliax.Indexer,
  index_name: :algoliax_people,
  object_id: :reference
  repo: MyApp.Repo,
  algolia: [...]

If using Agoliax with an Ecto schema it is possible to use reindex functions. Reindex will go through all entries in the corresponding table (or part if query is provided). Algoliax will save_objects by batch of 500. batch_size can be configured

config :algoliax,
  batch_size: 250

NOTE: Algoliax use by default the id column to order and go through the table. (cf Custom order column)

import Ecto.Query

# Reindex all

# Reindex all people with age greater than 20
query = from(p in People, where: p.age > 20)

# Reindex can also `force_delete`
query = from(p in People, where: p.age > 20)
People.reindex(query, force_delete: true)
People.reindex(force_delete: true)

# Reindex atomically (create a temporary index and move it to initial index)
Custom cursor column

If you don't have an id column, you can change it by setting the cursor_field option either in the global settings or in schema specific settings.

Make sure this column ensure a consistent order even when new records are created.

  • Using the global config:
config :algoliax,
  batch_size: 250,
  cursor_field: :reference
  • Indexer specific:
defmodule People do
  use Algoliax.Indexer,
    index_name: :algoliax_people,
    object_id: :reference,
    repo: MyApp.Repo,
    cursor_field: :inserted_at,
    algolia: [...]

Replicas configuration

Replicas can be configured using :replicas options. This option accepts the following :index_name, :algolia and :inherit. Use inherit: true on the replica if you want it to inherit from the primary settings, if custom settings in :algolia they will be merged.

use Algoliax.Indexer,
  index_name: :algoliax_people,
  object_id: :reference,
  repo: MyApp.Repo,
  algolia: [
    attributes_for_faceting: ["age"],
    searchable_attributes: ["full_name"],
  replicas: [
    [index_name: :algoliax_by_age_asc, inherit: true, algolia: [ranking: ["asc(age)"]]],
    [index_name: :algoliax_by_age_desc, inherit: false, algolia: [ranking: ["desc(age)"]]]

Copyright and License

Copyright (c) 2020 CORUSCANT (welcome to the jungle) -

This library is licensed under the BSD-2-Clause.