Std New

From FreeCAD Documentation
This page is a translated version of the page Std New and the translation is 5% complete.
Outdated translations are marked like this.

Std New

Ubicación en el Menú
Archivo -> Nuevo
Entornos de trabajo
Atajo de teclado por defecto
Introducido en versión
Ver también

Crea un documento vacío nuevo. FreeCAD también puede ser configurado para crear automáticamente un documento vacío nuevo al inicio, seleccionando la configuración apropiada en Editar -> Preferencias -> General -> Pestaña del Documento.

The Std New command creates a new empty document and makes it the active document.


  1. There are several ways to invoke the command:
    • Press the New button.
    • Select the File → New option from the menu.
    • Use the keyboard shortcut: Ctrl+N.


See also: Preferences Editor.

  • By default FreeCAD start without a new document. Check the Edit → Preferences... → General → Document → Create new document at start up option to change this behavior.
  • Some document properties: author name, company name and license information, can be preset: Edit → Preferences... → General → Document → Authoring and License.


See also: Property editor.

Most properties can also be changed in the dialog box of the Std ProjectInfo command.



  • DatosComment (String): Any comment that may apply.
  • DatosCompany (String): Company name.
  • DatosCreated By (String): Author name.
  • DatosCreation Date (String): Automatic date stamp (read-only).
  • DatosFile Name (String): The full path of the file. Blank if the document has not been saved (read-only).
  • DatosId (String): Not implemented yet.
  • DatosLabel (String): The name that will appear in the Tree view. Replaced by the name of the document after reopening.
  • DatosLast Modified By (String): Author name.
  • DatosLast Modified Date (String): Automatic date stamp (read-only).
  • DatosLicense (String): License type.
  • DatosLicense URL (String): License URL.
  • Datos (Hidden)Material (Map): Map with material properties.
  • Datos (Hidden)Meta (Map): Map with additional meta information.
  • DatosShow Hidden (Bool): If true, items that have been hidden in the Tree view will be displayed anyway. Hiding items in the tree can be useful when working on larger models.
  • DatosTip (Link): Not implemented yet.
  • DatosTip Name (String): Not implemented yet.
  • DatosTransient Dir (String): The transient directory used for recovery data (read-only).
  • Datos (Hidden)Uid (UUID): UUID of the document (read-only).
  • DatosUnit System (Enumeration): The document unit system. Initial value depends on the Default unit system. introduced in version 1.0


See also: Autogenerated API documentation and FreeCAD Scripting Basics.

To create a new document use the newDocument([name], [hidden=False]) method of the FreeCAD application. The document name must be unique, which is checked automatically. If no name is supplied, the document will be named "Untitled". If hidden=True is used, the new document won't be displayed in the GUI and no tab will appear for it.

import FreeCAD
from pathlib import Path

# The folder and filename we will use:
fld = 'D:/testfiles/'
fnm = fld + 'test.FCStd'

# Make sure fld exists:
Path(fld).mkdir(parents=True, exist_ok=True)

doc = FreeCAD.newDocument()


doc =