View in Clay

A modal is a secondary window that communicates or provides an action inside the same process.

modal window over a dark transparent background


  • Modals can be built with different sizes and configurations to best fit the amount of content you have.
  • We recommend that you do not use the full-width size, as it appears as though it's a completely new page. If you require this size, we recommend that you consider creating a new page instead of a modal.
  • Modals belong to a screen, therefore a modal should not be triggered from another modal window (see the Modal over modal section below).
  • When a modal has footer, the actions are placed inside and aligned to the right. There is an order of importance and the sequence is:
    1. Button link
    2. Secondary button
    3. Primary button (only one)


  • Use it to draw the user's attention to something that is more important.
  • Use it for simple content cases.
  • Use it if you need to interrupt the user flow to display concrete information or capture data from the user.


  • Do not use it for complex cases that require you to display a lot of information or to complete a long form. In these cases, use a new page instead.
  • Try not to trigger a modal window from another modal window. Modal windows are subordinate to pages.
  • Never completely cover the page's information with the modal window.

Multiple selection inside a modal

Selecting multiple items in a modal must be done by selecting each desired element through the checkbox. The selection will be finished by clicking in Done button at the modal footer.

multiple selection from a table inside a modal is done by selecting elements and clicking in Done button to complete the selection

Single selection inside a modal

Single selection must be done by clicking directly on the desired element. In this case, the element must not have a Choose or Select button. The modal doesn't have footer as there is no need.

single selection from a table inside a modal is done by selecting the element directly

Modal over modal is a not desired situation. Please, try to solve this situation in another way, like using a full page or driving the process to the correct place. In case this happens, make sure to provide a good experience preventing first modal closing by accidental interaction (as an example).


Modals are always displayed at the center of the screen and can be configured with the sizes shown in the table below:

Large896px wide modal on screen sizes greater than 992px. 600px wide modal on screen sizes between 768px and 992px.
Full widthA modal that stretches to fit the browser window, with 45px padding on every side.

modal sizes


modal window parts

  1. Modal header
    1. Title
    2. Close button
  2. Body
    1. Content: form, text, image...
  3. Footer
    1. Modal buttons

modal window metrics


Lexicon allows your modal window to have different configurations related to your needs. These needs vary from case to case and that is why not every modal in the system needs to be equal, but needs to follow certain rules.

This is the classic composition of a modal window with its three main parts: header, body, and footer.

modal window over a dark transparent background

Header and body

This configuration is used when you don't need a footer bar to place your icons.

modal window over a dark transparent background only header and body

Use this configuration when you just need to show text and buttons to agree or cancel.

modal window over a dark transparent background only body and footer

iframe in the body

You can of course add an iframe to a modal body at any time. See the iframe modal body Clay section for more information.

The modal overlay color is a main lighten 8% color with an alpha value of 0.8.

Modals for status messages

Modal headers can be configured to use modals as status messages. This solution is proposed to give more emphasis on blocking actions that the use must read and pay careful attention.

Never remove the icon in the title, as it provides the modal with a better user experience for accessibility.

Always use direct and concrete titles.

info, success, warning, error modal configurations in headers


When a modal is viewed on a mobile device, its look and feel transforms to the one shown below to provide a mobile friendly user experience. The modal occupies the whole screen, drawing the user's attention.

modal window mobile version always full screen