Locale

Change the locale of the datepicker, schedule and client side validation messages.

Language
English
English
English
French
German
German
German
Italian
Korean
Spanish
Catalan
Dutch
Portuguese
Portuguese
Arabic
Arabic
Bulgarian
Bangla
Bosnian
Czech
Greek
Estonian
Persian
Finnish
Danish
Hindi
Indonesian
Icelandic
Croatian
Japanese
Hungarian
Hebrew
Georgian
Central Kurdish
Khmer
Kyrgyz
Kazakh
Lithuanian
Latvian
Malay
Norwegian
Polish
Romanian
Russian
Slovak
Slovenian
Serbian
Serbian
Swedish
Thai
Turkish
Ukrainian
Uzbek
Vietnamese
Chinese
Chinese

Input Style

Themes

PrimeUIX
Aura Light Emerald Aura Light Emerald
Aura Dark Emerald Aura Dark Emerald
PrimeOne
Saga Blue Saga Blue
Vela Blue Vela Blue
Arya Blue Arya Blue
Bootstrap
Bootstrap Blue Light Bootstrap Blue Light
Bootstrap Purple Light Bootstrap Purple Light
Bootstrap Blue Dark Bootstrap Blue Dark
Bootstrap Purple Dark Bootstrap Purple Dark
Material Design
Material Indigo Light Material Indigo Light
Material Deep Purple Light Material Deep Purple Light
Material Indigo Dark Material Indigo Dark
Material Deep Purple Dark Material Deep Purple Dark
Material Design Compact
Material Compact Indigo Light Material Compact Indigo Light
Material Compact Deep Purple Light Material Compact Deep Purple Light
Material Compact Indigo Dark Material Compact Indigo Dark
Material Compact Deep Purple Dark Material Compact Deep Purple Dark
Legacy
Nova Light Nova Light
Nova Dark Nova Dark
Nova Colored Nova Colored
Luna Amber Luna Amber
Luna Blue Luna Blue
Luna Green Luna Green
Luna Pink Luna Pink

DataTable Row Group

Rows can be grouped in two ways, using rowGroup component or with groupRow attribute on a column.

DataTable Tag Documentation

DataTable is an enhanced version of the standard Datatable that provides built-in solutions to many commons use cases like paging, sorting, selection, lazy loading, filtering and more.

NameTypeRequiredDefaultDescription
id String false generated Unique identifier of the component in a namingContainer.
rendered boolean false true Boolean value to specify the rendering of the component, when set to false component will not be rendered.
binding UIComponent false generated An EL expression referring to a server side UIComponent instance in a backing bean.
widgetVar String false generated ('widget_' + componentClientId) Name of the client side widget.
allowUnsorting boolean false false Defines whether columns are allowed to be unsorted.
ariaRowLabel String false Label to read by screen readers on checkbox and radio selection.
cellEditMode String false eager Defines the cell edit behavior, valid values are "eager" and "lazy".
cellNavigation boolean false true Enables cell navigation with the keyboard for WCAG and screen reader compliance.
cellSeparator String false Separator text to use in output mode of editable cells with multiple components.
clientCache boolean false false Caches the next page asynchronously.
currentPageReportTemplate String false ({currentPage} of {totalPages}) Template of the currentPageReport UI.
dataLocale Object false The view locale Locale to be used in features such as sorting.
dir String false ltr Defines text direction, valid values are ltr and rtl.
disableContextMenuIfEmpty boolean false false Decides whether to disable context menu or not if a table has no records.
draggableColumns boolean false false Decides whether datatable columns can be reordered using dragdrop.
draggableRows boolean false false When enabled, rows can be reordered using dragdrop.
draggableRowsFunction MethodExpression false Method expression to execute after dragging row.
editInitEvent String false click Defines a client side event to open cell on editable table.
editMode String false row Defines edit mode, valid values are "row" and "cell".
editable boolean false false Controls incell editing.
editingRow boolean false false Defines if cell editors of row should be displayed as editable or not. False means display mode.
emptyMessage String false i18n Text to display when there is no data to display.
escapeText boolean false true Defines if headerText and footerText values on columns are escaped or not.
expandedRow boolean false false Defines if row should be rendered as expanded by default.
exportRowTag String false If XML data exporter in use, this allows customization of the row tag in the XML.
exportTag String false If XML data exporter in use, this allows customization of the document tag in the XML.
filterBy Object false Property to be used for filtering.
filterDelay int false 300 Delay to wait in milliseconds before sending each filter query.
filterEvent String false keyup Client side event to invoke filtering. If "enter" it will only filter after ENTER key is pressed.
filterNormalize boolean false false Defines if filtering would be done using normalized values (accents will be removed from characters).
filteredValue Object false List to keep the filtered data if filtering is enabled.
first int false 0 Index of the first data to display.
frozenColumns int false 0 Number of columns to freeze
frozenColumnsAlignment String false left Defines the alignment of frozen columns, valid values are 'left' and 'right'.
frozenRows int false 0 Number of rows to freeze starting from the beginning.
globalFilter String false Value of the global filter to use when filtering by default.
globalFilterFunction MethodExpression false Custom implementation to globally filter a value against a constraint.
globalFilterOnly boolean false false When true this will hide all column filters and allow all columns to be filtered by global filter only.
lazy boolean false True, if the value-binding is instance of LazyDataModel. Defines if lazy loading is enabled for the data component.
liveResize boolean false false Columns are resized live in this mode without using a resize helper.
liveScroll boolean false false Enables live scrolling.
liveScrollBuffer int false 0 Percentage height of the buffer between the bottom of the page and the scroll position to initiate the load for the new chunk. Value is defined in integer.
multiViewState boolean false false Whether to keep component state across views.
nativeElements boolean false false In native mode, treetable uses native checkboxes.
onExpandStart String false Client side callback to execute before row expansion.
onRowClick String false Client side callback to execute after clicking row.
pageLinks int false 10 Maximum number of page links to display.
paginator boolean false false Enables pagination.
paginatorAlwaysVisible boolean false true Defines if paginator should be hidden if total data count is less than number of rows per page.
paginatorPosition String false bottom Position of the paginator.
paginatorTemplate String false {FirstPageLink} {PreviousPageLink} {PageLinks} {NextPageLink} {LastPageLink} {RowsPerPageDropdown} Template of the paginator.
partialUpdate boolean false true When disabled, it updates the whole table instead of updating a specific field such as body element in the client requests of the dataTable.
reflow boolean false false Reflow mode is a responsive mode to display columns as stacked depending on screen size.
renderEmptyFacets boolean false false Render facets even if their children are not rendered.
resizableColumns boolean false false Decides whether datatable columns are resizable or not.
resizeMode String false fit Defines the resize behavior, valid values are "fit" and expand.
rowDragSelector String false td,span:not(.ui-c) Defines the element used to reorder rows using dragdrop.
rowEditMode String false eager Defines the row edit behavior, valid values are "eager" and "lazy".
rowExpandMode String false multiple Defines row expand mode, valid values are "single" and "multiple".
rowHover boolean false false Adds hover effect to rows, default is false. Hover is always on when selection is enabled.
rowIndexVar String false Name of iterator to refer each row index.
rowKey String false Unique identifier of row data.
rowSelector String false Client side check if rowclick triggered row click event not a clickable element in row content.
rowStatePreserved boolean false false Keeps state of its children on a per-row basis.
rowStyleClass String false Style class for each row.
rowTitle String false Title for each row.
rows int false 0 Number of rows to display per page. Default value is 0 meaning to display all data available.
rowsPerPageTemplate String false Template of the rowsPerPage dropdown.
saveOnCellBlur boolean false true Saves the changes in cell editing on blur, when set to false changes are discarded.
scrollHeight String false Height for scrollable data.
scrollRows int false 0 Number of rows to display in virtual scrolling mode.
scrollWidth String false Width for scrollable data.
scrollable boolean false false Makes data scrollable with fixed header.
selectAllFilteredOnly boolean false false When enabled, toggle select will only apply on filtered items.
selection Object false Reference to the selection data.
selectionDisabled boolean false false Disables row selection when true.
selectionMode String false Detected though the "selection" value expression. Enables data selection, valid values are "single" and "multiple".
selectionPageOnly boolean false true When using paginator and checkbox selection mode the select all checkbox in header will select the current page if true or all rows if false. When false, individual row unselections after 'select all' are preserved even across page navigation.
selectionRowMode String false new Indicates how rows of a DataTable may be selected, when clicking on the row itself (not the checkbox / radiobutton from p:column). The value `new` always unselects other rows, `add` preserves the currently selected rows, and `none` disables row selection.
selectionTextDisabled boolean false true Disables text selection on row click.
showGridlines boolean false false When enables, cell borders are displayed.
showSelectAll boolean false true Whether to show the select all checkbox inside the column's header.
size String false regular Size of the table content, valid values are "small", "regular" and "large".
skipChildren boolean false false Ignores processing of children during lifecycle, improves performance if table only has output components.
sortBy Object false Property to be used for sorting.
sortMode String false multiple Defines sorting mode, valid values are "single" and "multiple".
stickyHeader boolean false false Sticky header stays in window viewport during scrolling.
stickyTopAt String false Selector to position on the page according to other fixing elements on the top of the table.
stripedRows boolean false false Whether to display striped rows to visually separate content.
style String false Inline style of the component.
styleClass String false Style class of the component.
summary String false Summary attribute for WCAG.
tabindex String false 0 Position of the element in the tabbing order.
tableStyle String false Inline style of the table element.
tableStyleClass String false Style class of the table element.
touchable Boolean false Enable touch if supported by device. NULL uses global default or primefaces.TOUCHABLE. Default: globally enabled.
value Object true Datasource of the component.
var String true Name of the iterator variable that references each element in the data set.
virtualScroll boolean false false Loads data on demand as the scrollbar gets close to the bottom.
Loading...
Tag DocumentationNew DocumentationNew Documentation JSDoc Basic ColumnToggler ContextMenu Crud DisplayPriority Dynamic Columns Edit Facets Field Filter Gridlines Group Lazy MultiViewState Paginator Reorder Resize Responsive RowAdd RowColor RowExpansion RowGroup RowTitle RTL Scroll Selection Size Sort StickyHeader StripedRows SubTable
Header Row
RepresentativeNameCountryCompanyStatusDate
Amy Elsner
Amy ElsnerSinclair O Campain ArgentinaBuckley Miller Wright QUALIFIED10/24/2026
Amy ElsnerJames F Nicka FranceTruhlar And Truhlar Attys RENEWAL11/16/2026
Amy ElsnerAlejandro S Figeroa SpainRousseaux, Michael Esq UNQUALIFIED11/15/2026
Total Customers:3
Anna Fali
Anna FaliMayumi F Gillian ItalyFeiner Bros NEGOTIATION11/07/2026
Anna FaliWickens K Gaucho IndiaBuckley Miller Wright QUALIFIED11/13/2026
Anna FaliDavid P Morasca SpainRousseaux, Michael Esq UNQUALIFIED11/13/2026
Anna FaliMorrow I Malet RussiaFeiner Bros PROPOSAL11/17/2026
Total Customers:4
Asiya Javayant
Asiya JavayantIvar G Waycott ArgentinaKing, Christopher A Esq PROPOSAL10/27/2026
Asiya JavayantRicardo A Poquette ItalyTruhlar And Truhlar Attys RENEWAL10/25/2026
Asiya JavayantMorrow H Whobrey ItalyFeiner Bros QUALIFIED10/27/2026
Asiya JavayantLeon S Venere IndiaFeiner Bros UNQUALIFIED11/01/2026
Total Customers:4
Bernardo Dominic
Bernardo DominicCosta O Flosi JapanChemel, James L Cpa UNQUALIFIED11/14/2026
Bernardo DominicChavez Q Royster ItalyTruhlar And Truhlar Attys NEW10/30/2026
Bernardo DominicMayumi F Kusko United KingdomFeiner Bros QUALIFIED11/04/2026
Bernardo DominicMaisha A Albares RussiaMorlong Associates UNQUALIFIED11/15/2026
Bernardo DominicWickens J Bowley GermanyCommercial Press QUALIFIED11/11/2026
Bernardo DominicArvin R Amigon CanadaTruhlar And Truhlar Attys UNQUALIFIED11/17/2026
Total Customers:6
Elwin Sharvill
Elwin SharvillJuan W Royster CanadaMorlong Associates NEW11/04/2026
Elwin SharvillClaire K Stenseth CanadaTruhlar And Truhlar Attys RENEWAL10/25/2026
Elwin SharvillMorrow J Foller IndiaPrinting Dimensions PROPOSAL10/28/2026
Elwin SharvillLeon F Stenseth United KingdomChanay, Jeffrey A Esq NEW10/20/2026
Total Customers:4
Ioni Bowcher
Ioni BowcherCody L Garufi AustraliaTruhlar And Truhlar Attys UNQUALIFIED10/20/2026
Ioni BowcherMaria X Marrier FranceRousseaux, Michael Esq UNQUALIFIED10/29/2026
Ioni BowcherJefferson Y Iturbide JapanChanay, Jeffrey A Esq UNQUALIFIED10/30/2026
Ioni BowcherLeon K Slusarski CanadaTruhlar And Truhlar Attys NEGOTIATION11/08/2026
Total Customers:4
Ivan Magalhaes
Ivan MagalhaesIvar P Bolognia SpainKing, Christopher A Esq UNQUALIFIED11/05/2026
Ivan MagalhaesIvar L Poquette IndiaChanay, Jeffrey A Esq NEW11/17/2026
Ivan MagalhaesCosta H Wieser JapanBenton, John B Jr NEW11/09/2026
Ivan MagalhaesAdams Z Briddick IndiaRangoni Of Florence PROPOSAL11/16/2026
Ivan MagalhaesJennifer F Poquette AustraliaRousseaux, Michael Esq RENEWAL11/02/2026
Ivan MagalhaesMorrow R Shinko BrazilCommercial Press PROPOSAL11/17/2026
Ivan MagalhaesRodrigues Q Figeroa GermanyCommercial Press NEW10/22/2026
Total Customers:7
Onyama Limba
Onyama LimbaSilvio A Marrier RussiaChemel, James L Cpa NEGOTIATION11/16/2026
Onyama LimbaGreenwood T Ferencz CanadaBenton, John B Jr PROPOSAL10/26/2026
Onyama LimbaJennifer Q Butt FranceBuckley Miller Wright UNQUALIFIED11/11/2026
Onyama LimbaJennifer R Rulapaugh ItalyFeltz Printing Service PROPOSAL11/03/2026
Onyama LimbaFaith Q Sergi ArgentinaRousseaux, Michael Esq PROPOSAL11/11/2026
Onyama LimbaCody X Oldroyd FranceChanay, Jeffrey A Esq RENEWAL11/12/2026
Onyama LimbaClaire W Caudy ItalyCommercial Press UNQUALIFIED10/27/2026
Onyama LimbaCosta H Gaucho JapanChemel, James L Cpa NEGOTIATION10/20/2026
Onyama LimbaRodrigues Q Bowley AustraliaCommercial Press QUALIFIED10/22/2026
Total Customers:9
Stephen Shaw
Xuxue Feng
Xuxue FengIvar J Paprocki FrancePrinting Dimensions RENEWAL10/27/2026
Xuxue FengFrancesco J Kusko AustraliaBenton, John B Jr UNQUALIFIED11/05/2026
Xuxue FengJones F Venere SpainCommercial Press RENEWAL11/03/2026
Xuxue FengRicardo H Briddick JapanChanay, Jeffrey A Esq NEGOTIATION10/23/2026
Xuxue FengJohnson K Ostrosky ItalyRangoni Of Florence RENEWAL10/27/2026
Xuxue FengFrancesco D Malet ArgentinaCommercial Press RENEWAL10/23/2026
Xuxue FengGreenwood X Glick AustraliaRangoni Of Florence UNQUALIFIED11/07/2026
Total Customers:7
Rowspan
RepresentativeNameCountryCompanyStatusDate
Amy ElsnerSinclair O Campain ArgentinaBuckley Miller Wright QUALIFIED10/24/2026
Amy ElsnerJames F Nicka FranceTruhlar And Truhlar Attys RENEWAL11/16/2026
Amy ElsnerAlejandro S Figeroa SpainRousseaux, Michael Esq UNQUALIFIED11/15/2026
Anna FaliMayumi F Gillian ItalyFeiner Bros NEGOTIATION11/07/2026
Anna FaliWickens K Gaucho IndiaBuckley Miller Wright QUALIFIED11/13/2026
Anna FaliDavid P Morasca SpainRousseaux, Michael Esq UNQUALIFIED11/13/2026
Anna FaliMorrow I Malet RussiaFeiner Bros PROPOSAL11/17/2026
Asiya JavayantIvar G Waycott ArgentinaKing, Christopher A Esq PROPOSAL10/27/2026
Asiya JavayantRicardo A Poquette ItalyTruhlar And Truhlar Attys RENEWAL10/25/2026
Asiya JavayantMorrow H Whobrey ItalyFeiner Bros QUALIFIED10/27/2026
Asiya JavayantLeon S Venere IndiaFeiner Bros UNQUALIFIED11/01/2026
Bernardo DominicCosta O Flosi JapanChemel, James L Cpa UNQUALIFIED11/14/2026
Bernardo DominicChavez Q Royster ItalyTruhlar And Truhlar Attys NEW10/30/2026
Bernardo DominicMayumi F Kusko United KingdomFeiner Bros QUALIFIED11/04/2026
Bernardo DominicMaisha A Albares RussiaMorlong Associates UNQUALIFIED11/15/2026
Bernardo DominicWickens J Bowley GermanyCommercial Press QUALIFIED11/11/2026
Bernardo DominicArvin R Amigon CanadaTruhlar And Truhlar Attys UNQUALIFIED11/17/2026
Elwin SharvillJuan W Royster CanadaMorlong Associates NEW11/04/2026
Elwin SharvillClaire K Stenseth CanadaTruhlar And Truhlar Attys RENEWAL10/25/2026
Elwin SharvillMorrow J Foller IndiaPrinting Dimensions PROPOSAL10/28/2026
Elwin SharvillLeon F Stenseth United KingdomChanay, Jeffrey A Esq NEW10/20/2026
Ioni BowcherCody L Garufi AustraliaTruhlar And Truhlar Attys UNQUALIFIED10/20/2026
Ioni BowcherMaria X Marrier FranceRousseaux, Michael Esq UNQUALIFIED10/29/2026
Ioni BowcherJefferson Y Iturbide JapanChanay, Jeffrey A Esq UNQUALIFIED10/30/2026
Ioni BowcherLeon K Slusarski CanadaTruhlar And Truhlar Attys NEGOTIATION11/08/2026
Ivan MagalhaesIvar P Bolognia SpainKing, Christopher A Esq UNQUALIFIED11/05/2026
Ivan MagalhaesIvar L Poquette IndiaChanay, Jeffrey A Esq NEW11/17/2026
Ivan MagalhaesCosta H Wieser JapanBenton, John B Jr NEW11/09/2026
Ivan MagalhaesAdams Z Briddick IndiaRangoni Of Florence PROPOSAL11/16/2026
Ivan MagalhaesJennifer F Poquette AustraliaRousseaux, Michael Esq RENEWAL11/02/2026
Ivan MagalhaesMorrow R Shinko BrazilCommercial Press PROPOSAL11/17/2026
Ivan MagalhaesRodrigues Q Figeroa GermanyCommercial Press NEW10/22/2026
Onyama LimbaSilvio A Marrier RussiaChemel, James L Cpa NEGOTIATION11/16/2026
Onyama LimbaGreenwood T Ferencz CanadaBenton, John B Jr PROPOSAL10/26/2026
Onyama LimbaJennifer Q Butt FranceBuckley Miller Wright UNQUALIFIED11/11/2026
Onyama LimbaJennifer R Rulapaugh ItalyFeltz Printing Service PROPOSAL11/03/2026
Onyama LimbaFaith Q Sergi ArgentinaRousseaux, Michael Esq PROPOSAL11/11/2026
Onyama LimbaCody X Oldroyd FranceChanay, Jeffrey A Esq RENEWAL11/12/2026
Onyama LimbaClaire W Caudy ItalyCommercial Press UNQUALIFIED10/27/2026
Onyama LimbaCosta H Gaucho JapanChemel, James L Cpa NEGOTIATION10/20/2026
Onyama LimbaRodrigues Q Bowley AustraliaCommercial Press QUALIFIED10/22/2026
Stephen ShawJones J Poquette CanadaPrinting Dimensions UNQUALIFIED11/13/2026
Stephen ShawChavez W Amigon CanadaBuckley Miller Wright NEGOTIATION11/02/2026
Xuxue FengIvar J Paprocki FrancePrinting Dimensions RENEWAL10/27/2026
Xuxue FengFrancesco J Kusko AustraliaBenton, John B Jr UNQUALIFIED11/05/2026
Xuxue FengJones F Venere SpainCommercial Press RENEWAL11/03/2026
Xuxue FengRicardo H Briddick JapanChanay, Jeffrey A Esq NEGOTIATION10/23/2026
Xuxue FengJohnson K Ostrosky ItalyRangoni Of Florence RENEWAL10/27/2026
Xuxue FengFrancesco D Malet ArgentinaCommercial Press RENEWAL10/23/2026
Xuxue FengGreenwood X Glick AustraliaRangoni Of Florence UNQUALIFIED11/07/2026

Usage


<div class="card">
    <h5 class="first">Header Row</h5>
    <h:form>
        <p:dataTable var="customer" value="#{dtRowGroupView.customers}" sortBy="#{customer.representative.name}">
            <p:headerRow field="representative.name"
                         expandable="true" 
                         expanded="#{customer.representative.name != 'Stephen Shaw'}">
                
                <p:column colspan="6">
                    <div class="inline-flex align-items-center" style="vertical-align: middle">
                        <p:graphicImage name="images/avatar/#{customer.representative.image}" library="demo" width="32" style="vertical-align: middle"/>
                        <h:outputText styleClass="ml-2" value="#{customer.representative.name}"/>
                    </div>
                </p:column>
            </p:headerRow>

            <p:column headerText="Representative">
                <h:outputText value="#{customer.representative.name}" />
            </p:column>

            <p:column headerText="Name">
                <h:outputText value="#{customer.name}" />
            </p:column>

            <p:column headerText="Country">
                <span class="flag flag-#{customer.country.code}" style="width: 30px; height: 20px"/>
                <h:outputText style="vertical-align: middle; margin-left: .5rem" value="#{customer.country}"/>
            </p:column>

            <p:column headerText="Company">
                <h:outputText value="#{customer.company}" />
            </p:column>

            <p:column headerText="Status">
                <span class="customer-badge status-#{customer.status.name().toLowerCase()}">#{customer.status}</span>
            </p:column>

            <p:column headerText="Date">
                <h:outputText value="#{customer.date}">
                    <f:convertDateTime pattern="MM/dd/yyyy" type="localDate"/>
                </h:outputText>
            </p:column>

            <p:summaryRow>
                <p:column colspan="5" style="text-align:right">
                    <h:outputText value="Total Customers:"/>
                </p:column>
                <p:column>
                    <h:outputText value="#{dtRowGroupView.getTotalCount(customer.representative.name)}"/>
                </p:column>
            </p:summaryRow>
        </p:dataTable>
    </h:form>
</div>

<div class="card">
    <h5>Rowspan</h5>
    <h:form>
        <p:dataTable var="customer" value="#{dtRowGroupView.customers}">
            <p:column  headerText="Representative" groupRow="true">
                <p:graphicImage name="images/avatar/#{customer.representative.image}" library="demo"
                                width="32" style="vertical-align: middle"/>
                <h:outputText style="vertical-align: middle; margin-left: .5rem"
                              value="#{customer.representative.name}"/>
            </p:column>

            <p:column headerText="Name">
                <h:outputText value="#{customer.name}" />
            </p:column>

            <p:column headerText="Country">
                <span class="flag flag-#{customer.country.code}" style="width: 30px; height: 20px"/>
                <h:outputText style="vertical-align: middle; margin-left: .5rem" value="#{customer.country}"/>
            </p:column>

            <p:column headerText="Company">
                <h:outputText value="#{customer.company}" />
            </p:column>

            <p:column headerText="Status">
                <span class="customer-badge status-#{customer.status.name().toLowerCase()}">#{customer.status}</span>
            </p:column>

            <p:column headerText="Date">
                <h:outputText value="#{customer.date}">
                    <f:convertDateTime pattern="MM/dd/yyyy" type="localDate"/>
                </h:outputText>
            </p:column>
        </p:dataTable>
    </h:form>
</div>