UPDATED on August 10, 2023 by Gavin Montes

Inserting a Table

There are two ways of inserting a table into the editor window, and both have the same effect. Choose your preference.

Toolbar Menu Item

Place your cursor in the location the new table should be inserted and select the table icon in the toolbar. Hover over the Table item in the resultant menu. A grid will appear from which you can choose the number of table rows and columns to insert.

A screenshot of the table tool menu in the toolbar in edit mode of Omni CMS. The "Table" option of this menu is hovered, open to a grid from which the number of table rows and columns to be inserted can be selected.

Context Menu

Right click in the location the new table should be inserted to open the context menu. Hover over the Table item in the resultant menu. A grid will appear from which you can choose the number of table rows and columns to insert.

A screenshot of the table tool menu in the context menu in edit mode of Omni CMS. The "Table" option of this menu is hovered, open to a grid from which the number of table rows and columns to be inserted can be selected.

The table inserted into the editor will look like the image below:

A screenshot of a table in the Omni CMS editor with 4 columns and 3 rows, the first and last rows are white and the middle row is gray. There is a popup menu above the table with 8 buttons laid out horizontally in 3 groups. The first is a group of 2, the others two groups are groups of 2.

Style Specifications

Tables on our site's webpages maintain a uniform style to strengthen our brand. Odd numbered rows have a white background, and even numbered rows have a light grey background to help distinguish visually between content in each row. On desktop, a user can hover over a table row to highlight it, changing the backgorund color to a pale blue. Header rows and cells as well as Footer rows are visually distinguished by a dark blue background with white text. 

Basic Table Modification

The actions for basic table modification can be found in three different places: The Toolbar, the table's Pop-up Menu, and the table's Context Menu. These menus all contain the same basic actions, shown here:

Table Toolbar Menu

Click within an existing table to focus it (a blue border around the table visually indicates focus). Click the table icon in the editor's toolbar to open the Table Menu:

An screenshot of the toolbar in the Omni CMS editor with the Table Tool selected.

You will find that all of the actions listed at the start of this section (above) are present in this menu.

Table Context Menu

Click within an existing table to focus it (a blue border around the table visually indicates focus). Right click to open the context menu. If you used the context menu to create a table earlier, you will notice the difference. In this case, a table is focused, so the context menu has the 'Table Properties' and 'Delete Table' options enabled. The submenus Cell, Row, and Column also have their menu items enabled. These items were disabled outside of the table context. You will find that all of the actions listed at the start of this section (above) are present in this menu.

A screenshot of the context menu when a table is in focus. It contains the items: Link, Table, Table Properties, Cell, Row, Column, Delete Table. The items Table, Cell, Row, and Column indicate that they have submenus, but none are open in this image.

Table Pop-up Menu

Click within an existing table to focus it (a blue border around the table visually indicates focus). You should see a pop-up menu that looks like this:

A screenshot of the table popup menu with 8 buttons laid out horizontally in 3 groups. The first is a group of 2, the others two groups are groups of 2.

The buttons in the Table Pop-up Menu contain no text, only icons. You will find that all of the actions listed at the start of this section (above) are present in this menu, from right-to-left. I find this menu to be the most convenient for quick table actions, but you will find that there are no advanced table modification actions in this menu.

Advanced Table Modification

The actions for basic table modification can be found in two different places: The Toolbar and the table's Context Menu. These menus contain the same advanced actions, detailed below.

Cell Menu

The cell menu is available from both the table's context menu, and the toolbar when in the context of a table. It contains 3 menu items: Cell Properties, Merge Cells, and Split Cell. The Cell Properties item is always active in the context of a table, but Merge Cells and Split Cell are disabled unless the context is right for them to be enabled.

A screenshot of the table Context Menu with the Cell Menu active showing 3 items: Cell Properties, Merge Cells, and Split Cells. Only the first item in the submenu is enabled.

Cell Properties

A screenshot of the Table Cell Properties dialog. It has the following form fields: Width, Height, Cell Type, Scope, H Align, V Align, Class, and Custom Class. The form is open to the General Tab, with an inactive Advanced tab.The Cell Properties menu item opens up the Cell Properties dialog to the General Tab. We will not be covering the Advanced tab. None of the settings in the Advanced tab are supported by your Web Team, and we discourage their use. This also goes for the following fields in the General tab of the Cell Properties dialog: H Align and V Align. Width and Height should be used sparingly, our tables are responsive enough to handle these things automatically. 

Cell Type

Allows this cell to be changed between a Header Cell and a regular Cell. Header cells will be blue with white text, and will be automatically scoped if they are in the top row or the far-left column.

Scope

This setting only applies to header cells. Scope indicates whether a header cell is meant as a header for the row it is in, or the column that it is in. Scoping is handled automatically for headings in the top row, and far-left column. The only times you will need to manually scope a header cell is when:

  • The cell is not in the top row or far-left column.
  • The cell is in the top row AND far-left column. In other words, it is the furthest top-left cell in the table. This cell defaults to the Column scope, but can be set manually in the case that it is meant to be a Row heading.
Class and Custom Class

This sets a CSS class on the table cell. Don't use this unless you know what you're doing. In most cases, this is only used if the table you are editing is a Column Layout or other type of snippet. The Custom Class field is disabled unless you set the Class dropdown to '(custom)', in which case you can add a list of space-separated classes.

Merge Cells

This action merges multiple cells into a single cell. This menu item is only active when multiple cells are selected at once. You can select multiple cells at once by clicking and dragging vertically or horizontally to highlight mulitple cells in a row or column. Please note that merging cells makes tables difficult to understand for site visitors that use a screenreader. There few cases where it makes sense for this to be done, but it is generally discouraged.

Split Cells

This action splits any cells that have been merged, returning them to their original state. This menu item is only active when a merged cell (a cell that spans multiple rows or columns) is focused. Click within a cell to focus it. The cursor blinking within a cell is a visual indication that the cell is focused.

Row Menu

The row menu is available from both the table's context menu, and the toolbar when in the context of a table. It contains 8 menu items: Insert row before, Insert row after, Delete row, Row properties, Cut row, Copy row, Paste row before, and Paste row after.

Simple Row Operations (Insert row before, Insert row after, and Delete row)

These menu items perform the basic row operations stated in their labels to the row that is focused. Click within a cell to focus the cell and the row that the cell is in. The cursor blinking within a cell is a visual indication that the cell and its row are focused. Newly inserted rows will have the same arrangement of header cells, footer cells, and body cells as the row that is focused when the insertion takes place.

A screenshot of the Table Context Menu with the Row Menu active showing 8 items: Insert row before, Insert row after, Delete row, Row properties, Cut row, Copy row, Paste row before, and Paste row after.

Row Properties

A screenshot of the Table Row Properties dialog. It has the following form fields: Row Type, Alignment, Height, Class, and Custom Class. The form is open to the General Tab, with an inactive Advanced tab.The Row Properties menu item opens up the Row Properties dialog to the General Tab. We will not be covering the Advanced tab. None of the settings in the Advanced tab are supported by your Web Team, and we discourage their use. This also goes for the following fields in the General tab: Height, Class, Custom Class.

Row Type

Allows the entire row to be changed between a Body row, a Header row, and a Footer row. A Header row will always display at the top of the table regardless of its original placement, and a Footer row will always display at the bottom of the table regardless of its original placement. Both Header and Footer rows will be dark blue with white text. Making a row into a Header row helps communicate visually and to screen readers that the row contains column headings. Making a row into a Footer row helps communicate visually and to screen readers that the row contains summary information of the table like column totals or averages. Setting a row type as Header or Footer cannot be overridden by individual cells in a given row, e.g. if a header row contains a regular cell, that cell will still look and function like a header cell because it is in a header row (same goes for footer rows). However, in Body rows with individual cells set as Header Cells, the Cell setting takes precedence.

Alignment

Sets the justification of all cells in the row. This setting will be overridden by the text justification buttons in the toolbar, but is a good way to affect multiple cells at once.

Advanced Row Operations (Cut row, Copy row, Paste row before, and Paste row after)

These menu items perform the more advanced row operations stated in their labels to the row that is focused. Click within a cell to focus the cell and the row that the cell is in. The cursor blinking within a cell is a visual indication that the cell and its row are focused. Copying or cutting a row creates a special clipboard separate from the regular text clipboard. You can only paste a row from this special clipboard using the Paste row before, and Paste row after menu items. 

Column Menu

The column menu is available from both the table's context menu, and the toolbar when in the context of a table. It contains 3 menu items: Insert column before, Insert column after, Delete column.

Simple Column Operations (Insert column before, Insert column after, and Delete column)

These menu items perform the basic column operations stated in their labels to the column that is focused. Click within a cell to focus the cell and the column that the cell is in. The cursor blinking within a cell is a visual indication that the cell and its column are focused. Newly inserted columns will have the same arrangement of header cells, footer cells, and body cells as the column that is focused when the insertion takes place.

Column Properties

There is no column properties dialog available in the column menu like there are for Cell Properties and Row Properties, however we can still affect an entire column at once. You can select multiple cells at once by clicking and dragging vertically or horizontally to highlight mulitple cells in a row or column. Once multiple cells are selected, you can go to the Cell Properties option in the menu and change settings for all the cells selected. A common use case for this is selecting the entire left column and going to Cell Properties->Cell Type->Header cell to create a header column. This is alot easier than changing each cell in the column individually. You can even set each selected cell to have the same class in this way. An important issue with this process is if the selected cells all have different values in the Custom Class field. In this case, the Custom class must be set for each cell individually.

A screenshot of the Table Context Menu with the Column Menu active showing 3 items: Insert column before, Insert column after, Delete column.

Example Tables

The following examples are for visual comparison between the various combinations of header cells, header rows, and footer rows most likely to be used.