Algunos nombres en Mintlify se pueden cambiar en cualquier momento y otros quedan fijos al crearse:
- Modificables: el nombre de proyecto de tu implementación, el nombre de tu sitio de documentación en
docs.json y tu dominio personalizado.
- Fijos: el subdominio de tu implementación y el nombre de tu organización. Cambiar cualquiera de ellos requiere eliminar y volver a crear.
Renombrar el nombre de proyecto de tu implementación
El nombre de proyecto es el nombre visible que se muestra en la barra superior del panel. Para cambiarlo:
- Ve a la página de configuración general en tu panel.
- En el campo Deployment name, escribe el nuevo nombre. Los nombres deben tener entre 3 y 100 caracteres y contener solo letras, números, guiones y guiones bajos.
- Guarda los cambios.
Renombrar el proyecto requiere permiso para actualizar la implementación. Si el campo está deshabilitado, contacta a un admin de tu organización. Consulta Roles y permisos.
Cambiar el subdominio de tu implementación
Tu subdominio identifica tu implementación. Aparece en tu URL <subdomain>.mintlify.app y en la URL de tu panel, app.mintlify.com/<org>/<subdomain>. El subdominio no se puede cambiar después de crear la implementación.
Para usar un subdominio diferente, crea una nueva implementación con el nombre que quieras y luego elimina la anterior:
- Crea una nueva implementación conectada al mismo repositorio.
- Si usas un dominio personalizado, quítalo de la implementación anterior y luego agrégalo a la nueva. Consulta Dominio personalizado.
- Elimina la implementación anterior desde la Zona de peligro. Consulta Eliminar una implementación.
Eliminar una implementación es permanente y borra todos los datos de la implementación, incluido el historial de analíticas y cualquier implementación de vista previa asociada. La configuración del panel no se transfiere a la nueva implementación, así que vuelve a configurarla después de crearla.
Renombrar tu organización
Los nombres de organización no se pueden cambiar. Para usar un nombre de organización diferente, crea una nueva organización, vuelve a crear tus implementaciones en ella y elimina la organización anterior desde la Zona de peligro. Eliminar una organización es irreversible y requiere el rol de admin.
Tu subdominio y el nombre de tu organización rara vez son visibles para los lectores, así que puede que no necesites renombrar nada:
- El nombre del sitio que se muestra en tu documentación proviene del campo
name en docs.json. Puedes cambiarlo en cualquier momento.
- La URL que visitan los lectores puede ser un dominio personalizado como
docs.example.com, que puedes agregar o cambiar en cualquier momento.