.. include:: ../../../Includes.txt

.. index:: Event

.. _event:

===========
The event element
===========

This element is a representation of an event.
more information: `developers.google.com <https://developers.google.com/search/docs/data-types/event>`__

.. note::

   the page type must be webpage


.. figure:: ../../Images/EventBe.png
   :width: 800px
   :class: with-shadow
   :alt: The backend view of a new event

   The backend view of a new event


Available fields
===========

+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Field               | Description                                                                                                                                                                                 | Requried  |
+=====================+=============================================================================================================================================================================================+===========+
| Title               | The full title of the event.                                                                                                                                                                | yes       |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Description         | Description of the event. Describe all details of the event to make it easier for users to understand and attend the event.                                                                 | no        |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Start date          | The start date and start time of the event in ISO-8601 format                                                                                                                               | yes       |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| End date            | The end date and end time of the event in ISO-8601 format                                                                                                                                   | no        |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Images              | URL of an image or logo for the event or tour. Including an image helps users understand and engage with your event. We recommend that images are 1920px wide (the minimum width is 720px). | no        |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Location name       | The detailed name of the place or venue where the event is being held.                                                                                                                      | no        |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Street address      | The street address.                                                                                                                                                                         | yes       |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Postal code         | The postal code.                                                                                                                                                                            | yes       |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Address locality    | The locality in which the street address is, and which is in the region.                                                                                                                    | yes       |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Address region      | The region in which the locality is, and which is in the country.                                                                                                                           | no        |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+
| Address country     | The country. You can also provide the two-letter ISO 3166-1 alpha-2 country code.                                                                                                           | yes       |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+