Skip to end of metadata
Go to start of metadata

User Interface Elements in Metadata

Meeting Baseline Expectations

InCommon will phase in the Baseline Expectations program through much of calendar year 2018. Over time, this program will make some user interface elements mandatory (these are noted below). InCommon recommends adding all of these user elements to your metadata; in particular those that will become mandatory. For more information, see the Baseline Expectations wiki page.

User interface elements in Federation metadata are used by downstream applications to construct rich, dynamic user interfaces (UIs). Specifically, user interface elements in IdP metadata are used for the discovery and error pages at the SP, while user interface elements in SP metadata are used for the login, consent, and error pages at the IdP. The goal is to unify the various user interfaces associated with cross-domain single sign-on, thereby enhancing the overall user experience.

The InCommon Federation Manager has these input fields for user interface elements:

User Interface Element

Required under
Baseline Expectations?

Display NameAlready required of all InCommon IdPs and SPsYes
Information URLNoYes

Privacy Statement URL


Logo URLYesYes

By submitting these fields, the administrator adds the corresponding user interface elements to metadata. See the following help pages for guidance:

To better understand how the user interface elements are used, the InCommon Federation entity information pages display the values of all user interface elements on dynamic web pages. The information pages are refreshed daily, in parallel with InCommon metadata.

Technical Details

The SAML V2.0 Metadata Extensions for Login and Discovery specification defines an <mdui:UIInfo> extension element in SAML metadata. InCommon supports the following child elements of the <mdui:UIInfo> element:

  • <mdui:DisplayName>
  • <mdui:Description>
  • <mdui:InformationURL>
  • <mdui:PrivacyStatementURL>
  • <mdui:Logo>

An example follows:

<!-- User Interface Elements for InCommon IdPs and SPs -->
  <mdui:UIInfo xmlns:mdui="urn:oasis:names:tc:SAML:metadata:ui">
    <mdui:DisplayName xml:lang="en">...</mdui:DisplayName>
    <mdui:Description xml:lang="en">...</mdui:Description>
    <mdui:InformationURL xml:lang="en">...</mdui:InformationURL>
    <mdui:PrivacyStatementURL xml:lang="en">...</mdui:PrivacyStatementURL>
    <!-- the actual width and height of the image are input by the user -->
    <mdui:Logo width="130" height="80">...</mdui:Logo>
  • No labels


  1. Technically speaking, the first row in the "Federation Manager input fields table" is silent on whether there's a DisplayName requirement for SPs. (It just says "already required of all IdPs")

  2. According to SP User Interface Elements, DisplayName is required for SPs, too.  I'll fix the table.