# Form editor

## Creating your first form definition

After pressing the "New" button on the [Summary page](https://doc.orbeon.com/form-builder/summary-page), you reach the form editor (also known as form designer) proper. Form Builder requires that you provide two small pieces of information before starting:

* **Application Name.** Each form definition has an *application name* which identifies a group of forms that belong together. In practice, an application name might correspond to a project, or a department, or a company. For example, all forms built by Orbeon have the "orbeon" application name. *NOTE: Depending on your permissions, the application name might have been picked for you already, or you might have the choice of a restricted set of application names.*
* **Form Name.** Each form definition also has a *form name*, which identifies a unique form name within a particular application.

![Form Settings for a New Form Definition](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-67091bcfe64bf54deb13258a9ac35104e36917fc%2Fnew.png?alt=media)

Both application name and form name must respect a certain format:

* Use letters and optionally numbers and separators like "-" and "\_"
* Start with a letter
* Do not use spaces

*NOTE: One reason for these restrictions is that the names will eventually appear in your browser's URL bar when the form is deployed and it is better to have clean-looking URLs.*

For your first form, don't worry too much about those: just enter any name! You can always change these settings later!

You also may enter at this time a form title and description.

## General Form Builder layout

Form Builder's form editor is organized in 4 areas:

* **Top:** title area with status information and selection of the Form Builder user interface language.
* **Left:** the [toolbox](https://doc.orbeon.com/form-builder/form-editor/toolbox), which might scroll vertically depending on your browser or monitor size.
* **Bottom:** status icons and buttons.
* **Center:** WYSIWYG [form area](https://doc.orbeon.com/form-builder/form-editor/form-area) where you actually edit your form definition. This area might scroll vertically depending on your browser or monitor size or the size of the form you are editing.

![General Layout of Form Builder](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LEkBiSDvlXs3VWiO0Zu%2Fuploads%2Fgit-blob-8b4b08f855737f5484d27c2a7355c15d4edaa826%2Fgeneral-layout.png?alt=media)

## The top bar

On the top right corner of the top bar, you can change the Form Builder user interface language by clicking on one of the languages available. Currently, English and French are available. More languages may be added in the future.

Changing the language immediately updates the Form Builder user interface: you do not even need to save your form prior to using this feature.

*NOTE: This feature controls the language of the Form Builder user interface only. For localization of the form definition you are currently editing, see documentation below.*

![Form Builder's Top Bar](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEkBiSDvlXs3VWiO0Zu%2F-LEkBmMpnaxnftLGDglW%2F-LEkBtUMUx124SONFYs_%2Ftop.png?generation=1528743308704132\&alt=media)

## The buttons bar

See [Buttons bar](https://doc.orbeon.com/form-builder/form-editor/buttons-bar).

## Keyboard shortcuts

See [Keyboard shortcuts](https://doc.orbeon.com/form-builder/form-editor/keyboard-shortcuts).

### Other functions

In addition, the bottom bar displays status information, such as whether the current form definition was successfully saved.

## See also

* [Form area](https://doc.orbeon.com/form-builder/form-editor/form-area)
* [Toolbox](https://doc.orbeon.com/form-builder/form-editor/toolbox)
* [Buttons bar](https://doc.orbeon.com/form-builder/form-editor/buttons-bar)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.orbeon.com/form-builder/form-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.