.. _create_a_landing_page:

Create a Landing Page
---------------------

.. _19.3.1|VOSS-546|EKB-3607:


Refer to the Landing Page Definition topic.

.. note::
  
   To work on an existing landing page, we recommend that you clone the required
   landing page and work on the clone.

1. Log in as the provider administrator.
#. Choose the hierarchy level for the landing page.
#. Choose **Role Management > Landing Pages** to show the list view of
   Landing Pages (if configured). Note that this option is only available to
   Provider Administrators (or higher).
#. Click the **Add** button.
#. On the **Base** tab, enter a name for the Landing page.
#. Click the + button on the **Meta Tasks** field and fill in the necessary
   information. See :ref:`landing_page_definition` for details about available fields.
#. Click the + button on the **Sections** field and fill in the necessary
   information. See :ref:`landing_page_definition` for details about available fields.  
#. On the **Welcome Header** tab, enter the required Header Text, which is
   a single line static welcome message displayed on top of the Landing page.
#. Enter the required Line Text, for the welcome line displayed under the header,
   Use [userrole] as a placeholder to insert the current user's role.
   to serve as the header, for example ``/www/img/landingPageIcons/User.png``.
#. Click **Add** adjacent to links, for each required link in the section,
   and enter the link details. 
   
   Choose an **Icon** name from the dropdown to be displayed *only on* the
   landing page. To see the icons, refer 
   to :ref:`business-admin-portal-interface-custom-icon-names-reference`.
   
   The available fields are for menu items when
   creating Menu Layouts. If Type is selected, field display policies and
   configuration templates can be applied. The link Type is displayed as the
   chosen Display As item:

   * Form - Show an input form (for an Href value, a resource ends with
     "/add/").
   * Inline List - The link points to the first five list of items. See also
     :ref:`landing_page_definition` for more information on this field.
   * List - List view of a resource referenced by Type or Href. 
     If **List** is chosen as the **Display As** type, then the resulting list can
     also be filtered. See :ref:`menus_landing_configurable_filters`.
   * Tree - A tree view of resource to display (if the system Href provides 
     a tree path). 
   * Wizard - Execute a wizard referenced by the Href. The wizard resource 
     URL ends with "/0/".
   * IFrame - A URL specified as the Href value opens as an IFrame for
     cross-launching.

#. Arrange the desired order of the sections by clicking the up or down arrows
   to move the sections up or down respectively.      
#. Click **Save** when complete to create the landing page. 

To modify an existing landing page, click the relevant landing page name from the
Landing Page list view and edit the appropriate fields as described above.

When complete, assign the Landing Page to the appropriate roles. 

.. |VOSS-4-UC| replace:: VOSS-4-UC
.. |Unified CM| replace:: Unified CM