New in version 27.

Since Nextcloud 27, the files app has been rewritten to use new standards and frameworks. This means that the old documentation is no longer valid. We will update and document the new files app APIs and methods here.


To listen to files or folder changes or to trigger changes, you need to use the event-bus and use the following events:

  • files:node:created: the node has been created

  • files:node:deleted: the node has been deleted

  • files:node:moved: the node has been moved (and its data is already updated)

  • files:node:updated: the node data has been updated


import type { Node } from '@nextcloud/files'
import { subscribe } from '@nextcloud/event-bus'

subscribe('files:node:created', (node: Node) => {
  console.log('Node created', node)


To change views and parameters of the current Files app, we expose the router. This directly maps to the Vue router. You can check their own documentation to better understand the methods.

 * Trigger a route change on the files app
 * @param path the url path, eg: '/trashbin?dir=/Deleted'
 * @param replace replace the current history
 * @see
goTo(path: string, replace: boolean = false): Promise<Route>

 * Trigger a route change on the files App
 * @param name the route name
 * @param params the route parameters
 * @param query the url query parameters
 * @param replace replace the current history
 * @see
      name?: string,
      params?: Dictionary<string>,
      query?: Dictionary<string | (string | null)[] | null | undefined>,
      replace?: boolean,
): Promise<Route>


OCP.Files.Router.goToRoute('fileslist', { view: 'files' }, { dir: '/Folders/Group folder' })