.. index::
   single: Forms; Fields; UrlType

UrlType Field
=============

The ``UrlType`` field is a text field that prepends the submitted value with
a given protocol (e.g. ``http://``) if the submitted value doesn't already
have a protocol.

+-------------+-------------------------------------------------------------------+
| Rendered as | ``input url`` field                                               |
+-------------+-------------------------------------------------------------------+
| Options     | - `default_protocol`_                                             |
+-------------+-------------------------------------------------------------------+
| Inherited   | - `attr`_                                                         |
| options     | - `data`_                                                         |
|             | - `disabled`_                                                     |
|             | - `empty_data`_                                                   |
|             | - `error_bubbling`_                                               |
|             | - `error_mapping`_                                                |
|             | - `help`_                                                         |
|             | - `help_attr`_                                                    |
|             | - `help_html`_                                                    |
|             | - `label`_                                                        |
|             | - `label_attr`_                                                   |
|             | - `label_format`_                                                 |
|             | - `mapped`_                                                       |
|             | - `required`_                                                     |
|             | - `row_attr`_                                                     |
|             | - `trim`_                                                         |
+-------------+-------------------------------------------------------------------+
| Parent type | :doc:`TextType </reference/forms/types/text>`                     |
+-------------+-------------------------------------------------------------------+
| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UrlType` |
+-------------+-------------------------------------------------------------------+

.. include:: /reference/forms/types/options/_debug_form.rst.inc

Field Options
-------------

``default_protocol``
~~~~~~~~~~~~~~~~~~~~

**type**: ``string`` **default**: ``http``

If a value is submitted that doesn't begin with some protocol (e.g. ``http://``,
``ftp://``, etc), this protocol will be prepended to the string when
the data is submitted to the form.

Inherited Options
-----------------

These options inherit from the :doc:`FormType </reference/forms/types/form>`:

.. include:: /reference/forms/types/options/attr.rst.inc

.. include:: /reference/forms/types/options/data.rst.inc

.. include:: /reference/forms/types/options/disabled.rst.inc

.. include:: /reference/forms/types/options/empty_data.rst.inc
    :end-before: DEFAULT_PLACEHOLDER

The default value is ``''`` (the empty string).

.. include:: /reference/forms/types/options/empty_data.rst.inc
    :start-after: DEFAULT_PLACEHOLDER

.. include:: /reference/forms/types/options/error_bubbling.rst.inc

.. include:: /reference/forms/types/options/error_mapping.rst.inc

.. include:: /reference/forms/types/options/help.rst.inc

.. include:: /reference/forms/types/options/help_attr.rst.inc

.. include:: /reference/forms/types/options/help_html.rst.inc

.. include:: /reference/forms/types/options/label.rst.inc

.. include:: /reference/forms/types/options/label_attr.rst.inc

.. include:: /reference/forms/types/options/label_format.rst.inc

.. include:: /reference/forms/types/options/mapped.rst.inc

.. include:: /reference/forms/types/options/required.rst.inc

.. include:: /reference/forms/types/options/row_attr.rst.inc

.. include:: /reference/forms/types/options/trim.rst.inc