Skip to content

Table of contents

Apps suggestions doctype

The io.cozy.apps.suggestions doctype is used to store apps that are not yet installed, but might be useful for the user.

io.cozy.apps.suggestions are used by Cozy-Banks to extract which connectors can be suggested to the user based on his / her banking operations.


The available attributes in a io.cozy.apps.suggestions document are :

  • slug: {string} - The suggested app’s slug
  • silenced: {boolean} - Whether the user asked to silence the suggestion or not
  • reason: {Object} - An object describing why the suggestion is made
  • reason.code: {string} - A code describing the reason of the suggestion. See below for existing codes


io.cozy.apps.suggestions can have the following relationships:

  • transactions: an array of relationships pointing to documents that match with the app


  "slug": "deezer",
  "silenced": false,
  "reason": {
  "relationships": {
    "transactions": {
      "data": [
        { "_id": "12345abcdef", "_type": "" }
  "cozyMetadata": {
    "createdAt": "2019-04-01T11:41:32",
    "createdByApp": "banks"

See cozyMetadata documentation for more informations about it.

Reason codes

  • FOUND_TRANSACTION: a banking transaction matching this app was found
  • FOUND_CIPHER: a bitwarden cipher matching this app was found