Up to date

This page is up to date for Godot 4.0. If you still find outdated information, please open an issue.

Creating script templates

Godot provides a way to use script templates as seen in the Script Create Dialog while creating a new script:


A set of built-in script templates are provided with the editor, but it is also possible to create new ones and set them by default, both per project and at editor scope.

Templates are linked to a specific node type, so when you create a script you will only see the templates corresponding to that particular node, or one of its parent types. For example, if you are creating a script for a CharacterBody3D, you will only see templates defined for CharacterBody3Ds, Node3Ds or Nodes.

Locating the templates

There are two places where templates can be managed.

Editor-defined templates

These are available globally throughout any project. The location of these templates are determined per each OS:

  • Windows: %APPDATA%\Godot\script_templates\

  • Linux: $HOME/.config/godot/script_templates/

  • macOS: $HOME/Library/Application Support/Godot/script_templates/

If no script_templates is detected, Godot will create a default set of built-in templates automatically, so this logic can be used to reset the default templates in case you've accidentally overwritten them.

Project-defined templates

The default path to search for templates is the res://script_templates/ directory. The path can be changed by configuring the editor/script_templates_search_path setting in the ProjectSettings, both via code and the editor.

If no script_templates directory is found within a project, it is simply ignored.

Template organization and naming

Both editor and project defined templates are organized in the following way:



  • template_path is one of the 2 locations discussed in the previous two sections

  • node_type is the node it will apply to (for example, Node, or CharacterBody3D)

  • file is the custom name you can chose for the template (for example: platformer_movement or smooth_camera)

  • extension: will indicate which language the template will apply to (it should be gd for GDScript or cs for C#)

For example:

  • template_scripts/Node/smooth_camera.gd

  • template_scripts/CharacterBody3D/platformer_movement.gd

Default behaviour and overriding it

By default:

  • the template's name is the same as the file name (minus the extension, prettyfied)

  • the description is empty

  • the space indent is set to 4

  • the template will not be set as the default for the given node

It is possible to customize this behaviour by adding meta headers at the start of your file, like this: