[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
 [Expand]Getting Started
 [Expand]Basic Concepts and Terminology
 [Expand]Common Features
 [Expand]Creating the Designer and Viewer Applications
 [Collapse]Creating Dashboards
  [Collapse]Creating Dashboards in the WinForms Designer
    Creating a Dashboard
   [Expand]Providing Data
    Adding Dashboard Items
   [Expand]Binding Dashboard Items to Data
   [Collapse]Designing Dashboard Items
    [Expand]Scatter Chart
      Providing Data
      Conditional Formatting
      Printing and Exporting
    [Expand]Choropleth Map
    [Expand]Geo Point Maps
    [Expand]Range Filter
    [Expand]Text Box
    [Expand]Filter Elements
     Dashboard Item Group
     Tab Container
     Custom Item
   [Expand]Data Shaping
   [Expand]Appearance Customization
   [Expand]Data Analysis
    Converting Dashboard Items
   [Expand]Dashboard Layout
    Undo and Redo Operations
    Automatic and Manual Updates
    Saving a Dashboard
   [Expand]Printing and Exporting
  [Expand]Creating Dashboards on the Web
  [Expand]Creating Dashboards in the Visual Studio Designer
 [Expand]Visual Studio Integration
  End-User Documentation
 [Expand]Redistribution and Deployment
  Video Tutorials
 [Expand]Member Tables
 [Expand]API Reference
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


The Grid dashboard item allows you to customize its layout in various ways. You can manage the width of grid columns, specify the visibility of column headers, enable cell merging, etc.

To do this, use the Layout and Column Width Mode groups in the Design Ribbon tab of the Grid Tools contextual tab set.

Expanded Column Width Modes

The Grid dashboard item allows you to manage column widths using different modes. Use buttons in the Column Width Mode group to manage the column width modes.

The following modes are available.

AutoFit to Contents

The grid adjusts columns to the minimum width required to completely display their content automatically. If the entire content cannot be displayed within the dashboard item, horizontal scrolling is enabled.

To enable this mode in code, set the GridOptions.ColumnWidthMode property to GridColumnWidthMode.AutoFitToContents.

AutoFit to Grid

The grid adjusts the width of all columns to fit their content in an optimal way. If you are changing the size of the dashboard item, the width of columns is changed proportionally.

In code, set the GridOptions.ColumnWidthMode property to GridColumnWidthMode.AutoFitToGrid.


The grid allows you to adjust column widths manually. In code, set the GridOptions.ColumnWidthMode property to GridColumnWidthMode.Manual.

In this mode, you can adjust the width of individual columns in the following ways.

Expanded Column Header

Use the Column Headers button to toggle column header visibility.

To manage header visibility in code, use the GridOptions.ShowColumnHeaders property.

Expanded Cell Merging

The Grid allows you to merge neighboring cells with identical values . To do this, use the Merge Cells button.


Note that the Web Dashboard and Web Viewer do not support cell merging.


Banded rows are not available when cell merging is enabled.

In code, use the GridOptions.AllowCellMerge property.

Expanded Word Wrapping

The word wrapping feature enables the capability to display cell content on multiple lines if the size of a dashboard item is insufficient to completely display the cell content on a single line.


The word wrapping feature is not in effect when the AutoFit to Contents column width mode is enabled.

In code, use the GridOptions.WordWrap property to enable this capability.

Is this topic helpful?​​​​​​​