Std New

Open

Std File Menu

Std New
Menu location
File → New
Workbenches
All
Default shortcut
Ctrl+N
Introduced in version
-
See also
Std Open, Std Import

Description

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

Usage

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.

Preferences

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.

Properties

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

Data

Base

• DataComment (String): Any comment that may apply.
• DataCompany (String): Company name.
• DataCreated By (String): Author name.
• DataCreation Date (String): Automatic date stamp (read-only).
• DataFile Name (String): The full path of the file. Blank if the document has not been saved (read-only).
• DataId (String): Not implemented yet.
• DataLabel (String): The name that will appear in the Tree view. Replaced by the name of the document after reopening.
• DataLast Modified By (String): Author name.
• DataLast Modified Date (String): Automatic date stamp (read-only).
• DataLicense (String): License type.
• DataLicense URL (String): License URL.
• Data (Hidden)Material (Map): Map with material properties.
• Data (Hidden)Meta (Map): Map with additional meta information.
• DataShow 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.
• DataTip (Link): Not implemented yet.
• DataTip Name (String): Not implemented yet.
• DataTransient Dir (String): The transient directory used for recovery data (read-only).
• Data (Hidden)Uid (UUID): UUID of the document (read-only).
• DataUnit System (Enumeration): The document unit system. Initial value depends on the Default unit system. introduced in version 1.0

Scripting

See also: 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.saveAs(fnm)

FreeCAD.closeDocument(doc.Name)

doc = FreeCAD.open(fnm)
doc.save()

FreeCAD.closeDocument(doc.Name)

Open

Std File Menu

Std Base

• File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit

---

• Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences

---

• View:
  • Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
  • Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
  • Freeze display: Save views, Load views, Freeze view, Clear views
  • Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
  • Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
  • Zoom: Zoom In, Zoom Out, Box zoom
  • Document window: Docked, Undocked, Fullscreen
  • Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
  • Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
  • Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
  • Link navigation: Go to linked object, Go to the deepest linked object, Select all links
  • Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward

---

• Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager

---

• Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint

---

• Windows: Next, Previous, Tile, Cascade, Windows

---

• Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This

---

• Structure and Link: Std Part, Std Group, Make link, Make sub-link, Replace with link, Unlink, Import links, Import all links

User documentation

• Getting started
• Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
• Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

---

• Help: Tutorials, Video tutorials
• Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub