upstream-twenty/packages/twenty-docs/l/es/developers/extend/apps/layout/navigation-menu-items.mdx

---
title: Elementos del menú de navegación
description: Agrega entradas personalizadas a la barra lateral del espacio de trabajo — enlaces a vistas guardadas o URLs externas.
icon: bars
---

Un **elemento del menú de navegación** es una entrada en la barra lateral izquierda. Usa `defineNavigationMenuItem()` para distribuir enlaces personalizados en la barra lateral — normalmente uno por cada [vista](/l/es/developers/extend/apps/layout/views) que publiques — o para apuntar a URL externas.

```ts src/navigation-menu-items/example-navigation-menu-item.ts
import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';
import { EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER } from '../views/example-view';

export default defineNavigationMenuItem({
  universalIdentifier: '9327db91-afa1-41b6-bd9d-2b51a26efb4c',
  name: 'example-navigation-menu-item',
  icon: 'IconList',
  color: 'blue',
  position: 0,
  type: NavigationMenuItemType.VIEW,
  viewUniversalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
});
```

## Puntos clave

* `type` determina a qué enlaza el elemento del menú. Cada tipo se asocia con un campo identificador específico:

  | Tipo                                 | Qué hace                                             | Campo obligatorio                                                                                       |
  | ------------------------------------ | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
  | `NavigationMenuItemType.VIEW`        | Abre una vista guardada                              | `viewUniversalIdentifier`                                                                               |
  | `NavigationMenuItemType.LINK`        | Abre una URL externa                                 | `link`                                                                                                  |
  | `NavigationMenuItemType.FOLDER`      | Agrupa elementos anidados bajo una etiqueta          | `name` (y los elementos secundarios hacen referencia a la carpeta mediante `folderUniversalIdentifier`) |
  | `NavigationMenuItemType.OBJECT`      | Abre la página de índice predeterminada de un objeto | `targetObjectUniversalIdentifier`                                                                       |
  | `NavigationMenuItemType.PAGE_LAYOUT` | Abre un diseño de página independiente               | `pageLayoutUniversalIdentifier`                                                                         |

* `position` controla el orden en la barra lateral.

* El enum también contiene `NavigationMenuItemType.RECORD`, que se usa internamente para los favoritos de registros creados por el usuario; no se puede usar desde un manifiesto de aplicación (no hay ningún campo para hacer referencia a un registro).

* `icon` y `color` son opcionales y personalizan el aspecto de la entrada.

* `folderUniversalIdentifier` también está disponible en cualquier elemento para anidarlo dentro de un elemento padre de tipo `FOLDER`.

<Note>
**Error común:** crear un objeto sin un elemento de menú de navegación asociado hace que ese objeto sea inaccesible desde la barra lateral. A menos que sea un objeto técnico/interno, cada objeto personalizado debería tener una entrada en la barra lateral que apunte a él.
</Note>