---
title: "SQL-MENU-014: Insert menu item"
summary: "Insert a menu item row."
status: draft
owner: SAIF documentation team
last_reviewed: 2026-08-17
library: SAIF.Business.Menu
reference_type: package
---

# SQL-MENU-014: Insert menu item

Insert a menu item row.

## Classification

| Field | Value |
| --- | --- |
| **SQL ID** | SQL-MENU-014 |
| **Operation type** | Create |
| **Execution method** | Inline SQL |
| **Database** | Oracle |
| **Schema** | [unqualified]** |
| **Command type** | Text |
| **Business object** | `clsMenuItem` |
| **Criteria property** | `InsertSQL` |
| **Lifecycle method** | `BeforeInsert` |

## Parameters

| Parameter | Direction | Type | Max length | Description |
| --- | --- | --- | --- | --- |
| `:MenuItemSeqNum` | Input | Decimal | N/A | Menu item key. |
| `:MenuPageSeqNum` | Input | Decimal | N/A | Menu page key. |
| `:MenuCategoryCode` | Input | String | 5 | Menu category code. |
| `:ToolTip` | Input | String | 1000 | Item tooltip text. |
| `:VisibleFlag` | Input | String | 1 | Y/N visible flag. |
| `:PageOrder` | Input | Decimal | N/A | Display order. |
| `:UserId` | Input | String | 30 | Audit user. |

## Tables

| Table | Access | Columns used |
| --- | --- | --- |
| [MENU_ITEM](../database-tables.md#menuitem) | INSERT | `MENU_ITEM_SEQ_NUM`, `MENU_PAGE_SEQ_NUM`, `MENU_CATEGORY_CODE`, `TOOL_TIP_TXT`, `VISIBLE_FLAG`, `PAGE_ORDER_NUM`, `UPDATE_DATE`, `UPDATE_USER` |

## Sample SQL

```sql
INSERT INTO MENU_ITEM (
  MENU_ITEM_SEQ_NUM,
  MENU_PAGE_SEQ_NUM,
  MENU_CATEGORY_CODE,
  TOOL_TIP_TXT,
  VISIBLE_FLAG,
  PAGE_ORDER_NUM,
  UPDATE_DATE,
  UPDATE_USER)
VALUES (
  :MenuItemSeqNum,
  :MenuPageSeqNum,
  :MenuCategoryCode,
  :ToolTip,
  :VisibleFlag,
  :PageOrder,
  SYSDATE,
  :UserId)
```

## Operations and processes
- [Maintain a menu item together with its security-group assignments](../operations/maintain-menu-item-security.md)

## Business rules
- [BR-MENU-001: Optimistic contention on write](../business-rules.md#br-menu-001-optimistic-contention-on-write)

> **Note:** Statements marked with `**` could not be confirmed; treat
> as unknown until verified.

## Sources
- `SAIF.Business.Menu\clsMenuItem.vb`