[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
[Collapse]Office File API
  Demo Application
  Redistribution and Deployment
 [Collapse]Spreadsheet Document API
   Product Structure
   Getting Started
  [Expand]Spreadsheet Document
   Supported Formats
  [Expand]Cell Basics
  [Expand]Spreadsheet Formulas
   Defined Names
   Data Binding
  [Expand]Pivot Tables
  [Expand]Shapes, Pictures, Charts
  [Expand]Mail Merge
  [Collapse]Examples
   [Expand]Files
   [Expand]Workbooks
   [Expand]Worksheets
   [Expand]Rows and Columns
   [Collapse]Cells
     How to: Access a Cell in a Worksheet
     How to: Access a Range of Cells
     How to: Insert a Cell or Cell Range
     How to: Delete a Cell or Range of Cells
     How to: Create a Named Range of Cells
     How to: Change a Cell or Cell Range Value
     How to: Add Formulas to Cells
     How to: Add a Hyperlink to a Cell
     How To: Add a Comment To a Cell
     How to: Clear Cells of Content, Formatting, Hyperlinks and Comments
     How to: Copy Cell Data Only, Cell Style Only, or Cell Data with Style
     How to: Merge Cells or Split Merged Cells
   [Expand]Formulas
   [Expand]Import and Export Data
   [Expand]Data Binding
    Sorting
   [Expand]Mail Merge
    Search
   [Expand]Shapes
   [Expand]Charts
   [Expand]Sparklines
   [Expand]Formatting Cells
   [Expand]Conditional Formatting
   [Expand]Grouping
   [Expand]Filtering
   [Expand]Tables
   [Expand]Pivot Tables
   [Expand]Printing
   [Expand]Pictures
   [Expand]Protection
 [Expand]Word Processing Document API
 [Expand]PDF Document API
 [Expand]Excel Export Library
 [Expand]Snap Report API
 [Expand]Zip Compression and Archive API
 [Expand]Barcode Generation API
 [Expand]Unit Conversion API
 [Expand]API Reference
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

How to: Merge Cells or Split Merged Cells

  • Merge Cells

    This example demonstrates how to merge several cells into a single cell. To do this, use the Worksheet.MergeCells method with the passed range of cells to be merged.

    Note

    When you merge a cell range, the data (value, formula and format settings) of only the top left non-empty cell will appear in the resulting merged cell. The data contained in other cells of the original range will be lost.

    If all cells within the original range are empty, the range's top left cell format will be applied to the merged cell.

  • Split Merged Cells

    Call the Worksheet.UnMergeCells method with the passed range that contains merged cells to be split. Note that the content and formatting that were set in cells before merging will be lost (with the exception of the top left cell).

  • Split All Merged Cells in a Worksheet

    To get all merged cells in the specified cell range, use the Range.GetMergedRanges method.

The image below shows how cells are merged and split in a worksheet (the workbook is opened in Microsoft® Excel®). Note that only the "B2" data (the top left non-empty cell) appears in the merged cell.

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