Admin UI

Recombee Admin UI is available at

  • On registration an Organization is created for your company.

  • An Organization can contain multiple Databases, each with separate data and recommendation models.

  • Two Databases are created on registration - one for development purposes and one for production usage.

Recombee Admin UI

KPI console in the Admin UI


The interface consists of multiple sections:


  • Place for pinning the widgets that are the most important for you, so you see them right after logging in.

  • Use the star symbol for pinning.

    Pin widget to Dashboard


Items catalog

Items Catalog

Items catalog

Setting Logic to a Scenario

  • KPI

    • Console that contains widgets showing important data such as number of recommendations, number of ingested interactions or success rate of the recommendations per scenario.

    • Read more about the success metrics.

  • Items and Users

    • Catalog of the items and users that are contained in the Recombee database with their properties.

  • Scenarios

    • Section for setting behavior of recommendations in each scenario.

    • Read more about the scenarios here.

  • Business Rules

  • Widgets

    • Section for creating HTML Widgets that are used for displaying recommendations at your site.

  • Catalog Feed

    • Section for setting a catalog feed, which can be used for synchronizing the items to Recombee

  • Settings

    • Section for getting API identifier & tokens for connecting to the Recombee API and managing access to the Database (Manage Access button).


  • Section for admins of the Organization for managing access (Manage Access button), getting information about limits/usage on Organization level and about selected Billing Plan.

Invites & Access Levels

Colleagues can be invited to the whole Organization or just particular Database (use the Manage Access button in Settings).

Manage access

A level of access can be set:

Access to Database

  • VIEW

    • Can view the Database (see KPI, Items & Users, Scenarios …) but cannot change any settings

    • Cannot see the API tokens for manipulating the Database

  • EDIT

    • Can make changes to the Database

    • Can see the API tokens for manipulating the Database

Access to Organization

  • VIEW

    • Can view all the Databases in the Organizations but cannot change any settings

    • Cannot see the API tokens of these Databases

  • EDIT

    • Can make changes to all the Databases in the Organizations

    • Can see the API tokens for manipulating these Databases


    • Can see and change the billing info of the Organization.

Success metrics in KPI

You can see in the KPI how many clicks / purchases / bookmarks etc. was based on the recommendations.

For each of the metrics there are estimated and reported values.

Reported vs. Estimated metric

Reported vs. Estimated metric

Estimated Metrics

  • Estimates are based on a time window: If an item is recommended to a user, and this user subsequently interacts with that item within a time window, it is considered a successful recommendation

  • These metrics don’t need any implementation and usually give reasonable estimates of the success. However, they don’t work for example in case of emailing (users look at the recommendations usually hours later, so their clicks are not counted as they are out of the the time window) or at sites where items can be easily found by different means than recommendations. In these cases explicit reporting of recommendations’ success is a must.

Reported Metrics

Reported vs. Estimated metric
  • Successful recommendations explicitly reported to Recombee.

  • Each recommendation request returns a unique recommId (e.g. 3f6ad2f2-a3f1-4ba1-a690-f4f01f76d4eb) that can be passed to recommId parameter of an interaction (Detail View, Purchase, etc.) in order to mark that interaction as based on recommendation.

  • When properly integrated, the reported metrics should give you exact numbers about successful recommendations.

  • Therefore we suggest to implement sending of recommId in interactions whenever possible.