View source for How to create or modify a Form

{{FeatureInfo
|editions=wcm,ecm,comm
|fromversion=6.0
|wikicomplete=100%
|interest=enduser,builder
|enduserlink=
|builderlink=
|developerlink=
|sysoplink=
}}
 
{| style="margin-left:2em;" align="right"
| __TOC__
|}

=Overview=
{{LeadImage|FormPortlet.png|Form}}

Forms provide possibility to collect information from users. Forms consist of field elements, contain a submit button and can give a message to the users after filling it out.

Forms are [[Content Type]]s like Articles or Folders, so you can add a new one as you add other types, or you can list the submitted ones.
{{clear}}

=Modify an existing form=

You can add new fields to any existing Form.

To do so, select the form you wish to modify (for example the built-in Contact form under Default_Site/features/form), click on '''Settings''' on the right and select '''Manage fields''' from the drop-down list.
{{Screenshot|Form-edit.png|Edit fields of an existing form}}

After adding, deleting or modifying fields, you can see the changes on every [[Form Portlet]] bound to this form.
{{Screenshot|Form-new-field.png|New field on the Contact us form}}

=Create your own form=
Forms are [[Content Type]]s in the system, so you can add a new one to your site as you add other type of contents.

You can set the fields of your new Form as it is described in the previous section.

After you costumized your Form, you should display it in a [[Form Portlet]].
Create a new Form Portlet on your page and set at least two properties:
*Set Form path to the path of your form
*Set View to /Root/global/contentviews/FormItem/Edit.ascx
{{Screenshot|Form-portlet.png|Form portlet}}

If you want to display the list of submitted forms, add a new [[Content List Portlet]] and bind it to your form.
{{Screenshot|Form-submitted.png|List of submitted forms}}

=Related links=
*[[Form Portlet]]

=References=
There are no external references for this article.