Empty

Display empty states when no data is available or to guide users to take action.

No items found

Get started by creating a new item.

Usage

<%= ui.empty do %>
  <%= ui.empty_icon "user" %>
  <%= ui.empty_title "No results" %>
  <%= ui.empty_description "Try adjusting your search." %>
<% end %>

<%= ui.empty do %>
  <%= ui.empty_icon "user" %>
  <%= ui.empty_title "No projects" %>
  <%= ui.empty_description "Create your first project." %>
  <%= ui.empty_actions do %>
    <%= ui.btn "New project", url: "#" %>
  <% end %>
<% end %>
Subcomponents
NameHelperDescription
empty_iconui.empty_iconIcon displayed at the top of the empty state. Inherits from Ui::Icon::Component.
empty_titleui.empty_titleMain title text for the empty state.
empty_descriptionui.empty_descriptionSecondary description text with muted styling.
empty_actionsui.empty_actionsContainer for action buttons.

Examples

With actions

No upcoming meetings

Create a meeting to get started.

<%= ui.empty do %>
  <%= ui.empty_icon "github" %>
  <%= ui.empty_title "No upcoming meetings" %>
  <%= ui.empty_description "Create a meeting to get started." %>
  <%= ui.empty_actions do %>
    <%= ui.btn "Create meeting", url: "#" %>
    <%= ui.btn "View docs", url: "#", variant: :outline %>
  <% end %>
<% end %>

Single action

No projects yet

Get started by creating a new project.

<%= ui.empty do %>
  <%= ui.empty_icon "github" %>
  <%= ui.empty_title "No projects yet" %>
  <%= ui.empty_description "Get started by creating a new project." %>
  <%= ui.empty_actions do %>
    <%= ui.btn "New project", url: "#" %>
  <% end %>
<% end %>

Without actions

No results found

Try adjusting your search or filter to find what you're looking for.

<%= ui.empty do %>
  <%= ui.empty_icon "github" %>
  <%= ui.empty_title "No results found" %>
  <%= ui.empty_description "Try adjusting your search or filter to find what you're looking for." %>
<% end %>