How to Merge Cells in Jira: Options and Workarounds

How-to basics · Updated November 6, 2026

How to Merge Cells in Jira: Options and Workarounds

You cannot merge table cells with Jira’s standard issue editor: it does not provide a native merge-cells command. To show related information together, redesign the table or place the table in Confluence, where cell merging is supported, and link to it from Jira. First check whether you need a visual layout change or a true merged cell, because the right fix depends on where the table lives.

What You’ll Need

  • Permission to edit the Jira issue if you plan to change its description or add a link.
  • The issue and the table you want to change. Note which cells should appear as one, and whether their contents need to remain editable as separate items.
  • For a genuine merged table cell, access to a Confluence space where you can create or edit a page. If your organisation does not use Confluence, ask a Jira administrator whether an approved Marketplace app is available.

Jira tables in issue descriptions are for displaying information, not for spreadsheet-style layout editing. The steps below explain how to make a practical Jira-side substitute and how to use Confluence if merging is essential.

Step-by-Step

  1. Identify where the table is. Open the Jira issue and check whether the table is in the description, a comment, or another field. The standard Jira issue editor does not offer a merge command for its tables. If you are looking at a board, backlog, or issue list, those rows and columns are part of Jira’s interface; they are not a table you can edit by merging cells. If the table is in a custom field, its available controls depend on the field or app that supplies it.

  2. Choose between a layout workaround and a true merge. If the goal is to make a label or heading cover several rows, try simplifying the Jira table so it does not need a spanning cell. If the information must visibly occupy a single cell across multiple rows or columns, use Confluence or an approved app. Do not spend time searching Jira’s table toolbar for a hidden merge option: the standard issue editor does not include one.

  3. Edit the issue table for a Jira-only workaround. Open the issue, choose Edit or click into the description if inline editing is available, and focus the rich text editor. Add or adjust the table using the editor’s table controls, if available in your Jira version. Reorganise the content so the information fits an ordinary row-and-column layout. For example, if one heading was meant to span three detail columns, use it as a normal heading in the row above the table, then keep the three column headings separate. Save or update the issue and check the result in the rendered view.

  4. Use repeated labels instead of a merged category cell. If a category label would otherwise span several rows, put that label in each relevant row, or add a dedicated category column. For example, replace one merged Testing cell next to three test cases with three rows that each begin with Testing. Repeating a short label is often clearer when someone sorts, copies, or reads the information with assistive technology. If repetition would make the table noisy, move the category into a heading above a smaller table.

  5. Move a table that genuinely needs merged cells to Confluence. Create or edit a Confluence page in a space where you have permission. Insert a table, enter the content, and select the adjacent cells that should become one cell. Use Merge cells in the table toolbar or its cell-actions menu; the exact control placement can vary with the Confluence editor. Review the merged result before publishing. If the command is unavailable, confirm you selected adjacent cells in the same table and check whether your Confluence version or permissions support the action.

  6. Link the Confluence page from the Jira issue. Copy the page link, return to the Jira issue, and add it to the description or a comment with a short explanation, such as See the test matrix for the grouped table. In Jira Cloud, pasting a Confluence URL may display a smart link; you can keep the preview or change its display style if the editor offers that choice. Save the issue, then open the link to verify that intended readers can access the page. A link does not grant Confluence access, so check the page’s permissions separately.

  7. Consider an app only when the table must stay in Jira. If the layout must be editable directly on the issue, ask your Jira administrator to review approved Marketplace apps that provide richer tables or custom fields. Check the app’s compatibility with your Jira deployment, permissions, data handling, and licensing before installing it. Do not assume an app’s cell-merging controls will work in every Jira field or in existing comments.

Common Mistakes

  • Looking for a command that Jira does not provide. In the standard Jira issue editor, there is no native merge-cells action. Toolbar options can vary by Jira version, editor, and installed apps, but a different table toolbar does not mean that Jira has merged the cells.

  • Leaving neighbouring cells blank and calling it a merge. A blank cell beside a label may look like a wider heading in one view, but it remains a separate cell. Column widths, screen size, or later edits can make the layout appear different. Use this only as a temporary visual approximation, not when the table structure matters.

  • Using spaces or repeated punctuation to fake alignment. Spaces, tabs, and strings of hyphens rarely line up reliably in a browser, and they are difficult to maintain. Use a real table, a simple heading, or a linked Confluence page instead.

  • Assuming a Jira board is an editable spreadsheet. Board columns usually represent workflow statuses, while issue cards represent work items. You cannot merge those interface elements as table cells. Change the board configuration only if you intend to change how work is displayed, not to create a merged table.

  • Moving confidential content to a page with broader access. A Confluence page may have different viewers from its linked Jira issue. Review page restrictions before sharing the link, especially for customer, employee, or project-sensitive details.

Tips

  • Keep Jira descriptions concise. If a table needs complex headers, merged cells, notes, or several sections, a Confluence page is often easier to read and maintain.

  • Use clear column headings and avoid relying on colour alone to explain groups. A text label such as Phase 1 remains understandable in a copied table and for readers who cannot distinguish the colours.

  • When grouping rows, consider whether repeating the group name will help readers scan or filter the information. For a short table, repeated labels can be more useful than a merged cell.

  • Check the rendered issue after saving. The editor view and the displayed issue can differ, and long text may wrap or make a workaround look untidy.

  • If your team uses a Jira app or a customised editor, document the supported workflow for teammates. Instructions for the standard Jira editor may not match a custom field supplied by an app.

Troubleshooting

The table toolbar has no Merge cells option. That is expected in the standard Jira issue editor. Use the layout alternatives above, or create the table in Confluence. If the table comes from a custom field or app, check that product’s documentation or ask its administrator whether it supports merging.

I cannot edit the description. Check whether the issue is in a project where you have edit permission, and whether the field is available on the issue’s edit screen. A Jira administrator may need to review the project permissions or screen configuration. If the text is in a comment, comments generally have their own editing permissions and controls; changing the description will not change the comment.

The table controls do not appear. Click inside the table in the rich text editor and look for contextual table controls. If you are viewing the issue rather than editing it, choose the available edit action first. Some fields, older interfaces, and app-provided editors do not expose the same table tools. If the control still does not appear, use a simple text layout or ask your Jira administrator which editor is active.

The Confluence merge command is disabled or missing. Confirm that the selected cells are adjacent and belong to the same table, then check that you are editing the page rather than viewing it. Editor capabilities can differ across Confluence versions and configurations. If the action remains unavailable, use separate cells with clear headings or contact your Confluence administrator.

The Jira link opens an access error. The person opening it may not have permission to view the Confluence page or space. Ask the page owner to check the restriction settings and grant the appropriate access. Avoid copying the table into a public location as a shortcut if the content is restricted.

The table looks different after saving. Reopen the issue and inspect the rendered table at the screen size your team normally uses. Simplify long headings, remove decorative spacing, or move the full table to Confluence. If the display changes only in one browser or field, capture the issue key, browser, and editor details for your Jira administrator.

Frequently Asked Questions

Can you merge cells in Jira?
No, not in the standard Jira issue-description table editor. Jira does not provide a native merge-cells command there. Use a redesigned table, Confluence, or an approved app if you need a true merged cell.

Can I merge cells in a Jira comment?
Jira comments are not a spreadsheet grid, and the standard comment editor does not provide a cell-merging feature. For structured information, use a simple table in a supported rich text field if available, or link to a Confluence page.

Does Jira Cloud have a hidden keyboard shortcut for merging cells?
There is no standard Jira Cloud keyboard shortcut that merges table cells. Shortcuts available in a particular browser, editor, or app should not be assumed to add a feature that the Jira editor does not provide.

Can I merge cells in Jira Data Center?
The standard Jira issue editor does not offer native cell merging there either. The exact editing experience can depend on the Data Center version and installed apps, so check your configured editor if the interface differs from the standard one.

Will a Confluence table update automatically inside Jira?
A link or smart link points to the Confluence page; it is not a copy of the table that Jira edits as part of the issue. Update the table on the Confluence page, and readers who have access can follow the link to see the current version.

What is the best alternative if I only need one heading across columns?
Put the heading in a separate line above the Jira table, then use ordinary headings for each column. This keeps the structure understandable without suggesting that separate cells have been merged.

Related

Try it: the Date Difference Calculator: days, months, years and weekdays between two dates, with the DATEDIF formulas.

More in How-to basics

Sources: Function behaviour and menu paths: Microsoft Support documentation for Excel. Method & sources

Spotted an error in this guide? Let us know.