Available on: All Plans
Projects allow you to create logical groupings of your forms and apply global settings that apply to all forms in a project.
Creating a project
Creating a project is easy! From your dashboard, click the button in the top right that says +New Project.
Dashboard projects are managed through the Formspree interface. You can create forms, update settings, and configure plugins without any code, all in the Formspree dashboard. Here are some things you should know about dashboard projects:
- Dashboard projects currently cannot take advantage of custom backend validation. Certain plugins, such as the Mailchimp plugin, still create their own validation rules. (For example, requiring an email field).
- Dashboard projects can work with the Formspree React library. To do so, use the form hashid (the 8 character alphanumeric id in your form endpoint) in place of a form key. You shouldn't use FormspreeProvider with a dashboard project.
Command line projects
Command line projects are managed with the Formspree CLI. You can create forms, update settings, and configure plugins using the formspree.json file, and deploy those changes using the CLI deploy command. Here are some things you should know about CLI projects:
- CLI projects can take advantage of custom backend validation rules, and validation rules enabled automatically when you add an action. See a list of actions and associated rules in the docs.
- CLI projects are designed to work seamlessly with the Formspree React library. Be sure to wrap your React app with a FormspreeProvider, supplying your Project ID. Then use any key to identify your form in the useForm hook.
Creating a form in a project
For dashboard projects, you can begin adding forms by clicking the + New Form button. You will see an option to select the project to which your form will be added.
Note that you can only add forms to dashboard projects in the Formspree dashboard. To add forms to CLI projects, please use the Formspree CLI.
Migrating forms across projects
If you want to move a form already created to a different project, you can visit the form's settings tab and scroll to the option Move Form to Project. From here you can choose to move to any projects that you have access to.
If you are moving a form that was not in a project previously, note that some settings will now inherit project settings instead. Similarly, if you remove a form from a project, certain project settings will no longer apply.