Skip to main content
Popups block normal mouse hovering detection behind them. If not modal, they can be closed by clicking anywhere outside them, or by pressing ESCAPE. Their visibility state is held internally instead of being held by the programmer.

​
Opening Popups

​
OpenPopup

void ImGui::OpenPopup(const char* str_id, ImGuiPopupFlags popup_flags = 0)
void ImGui::OpenPopup(ImGuiID id, ImGuiPopupFlags popup_flags = 0)
Mark popup as open (don’t call every frame!).
​
str_id
const char*
Popup identifier string
​
id
ImGuiID
Popup identifier ID
​
popup_flags
ImGuiPopupFlags
default:"0"
Popup flags (see ImGuiPopupFlags_)
// Example
if (ImGui::Button("Open Popup")) {
    ImGui::OpenPopup("my_popup");
}

if (ImGui::BeginPopup("my_popup")) {
    ImGui::Text("Popup content");
    if (ImGui::Button("Close")) {
        ImGui::CloseCurrentPopup();
    }
    ImGui::EndPopup();
}

​
OpenPopupOnItemClick

void ImGui::OpenPopupOnItemClick(const char* str_id = NULL, ImGuiPopupFlags popup_flags = 0)
Helper to open popup when clicked on last item. Default to ImGuiPopupFlags_MouseButtonRight.
​
str_id
const char*
default:"NULL"
Popup identifier (NULL = use last item’s ID)
​
popup_flags
ImGuiPopupFlags
default:"0"
Popup flags
// Example
ImGui::Button("Right-click me");
ImGui::OpenPopupOnItemClick("item_popup");

if (ImGui::BeginPopup("item_popup")) {
    ImGui::Text("Right-clicked!");
    ImGui::EndPopup();
}

// Left-click
ImGui::Button("Left-click me");
ImGui::OpenPopupOnItemClick("left_popup", ImGuiPopupFlags_MouseButtonLeft);

​
CloseCurrentPopup

void ImGui::CloseCurrentPopup()
Manually close the popup we have begin-ed into. 
// Example
if (ImGui::BeginPopup("my_popup")) {
    if (ImGui::Button("Close") || ImGui::IsKeyPressed(ImGuiKey_Escape)) {
        ImGui::CloseCurrentPopup();
    }
    ImGui::EndPopup();
}

​
Regular Popups

​
BeginPopup

bool ImGui::BeginPopup(const char* str_id, ImGuiWindowFlags flags = 0)
Return true if the popup is open, and you can start outputting to it.
​
str_id
const char*
Popup identifier
​
flags
ImGuiWindowFlags
default:"0"
Window flags
​
return
bool
True if popup is open
// Example
if (ImGui::Button("Show Popup")) {
    ImGui::OpenPopup("simple_popup");
}

if (ImGui::BeginPopup("simple_popup")) {
    ImGui::Text("This is a simple popup");
    ImGui::Separator();
    if (ImGui::Selectable("Option 1")) { }
    if (ImGui::Selectable("Option 2")) { }
    if (ImGui::Selectable("Option 3")) { }
    ImGui::EndPopup();
}

​
EndPopup

void ImGui::EndPopup()
Close popup. Only call EndPopup() if BeginPopupXXX() returns true.

​
BeginPopupModal

bool ImGui::BeginPopupModal(const char* name, bool* p_open = NULL, ImGuiWindowFlags flags = 0)
Block every interaction behind the window, cannot be closed by user, add a dimming background, has a title bar.
​
name
const char*
Modal window name/title
​
p_open
bool*
default:"NULL"
Optional pointer to bool to show close button
​
flags
ImGuiWindowFlags
default:"0"
Window flags
​
return
bool
True if modal is open
// Example
static bool show_modal = false;

if (ImGui::Button("Open Modal")) {
    show_modal = true;
    ImGui::OpenPopup("My Modal");
}

if (show_modal) {
    if (ImGui::BeginPopupModal("My Modal", &show_modal)) {
        ImGui::Text("This is a modal dialog");
        ImGui::Separator();
        
        if (ImGui::Button("OK")) {
            ImGui::CloseCurrentPopup();
            show_modal = false;
        }
        ImGui::SameLine();
        if (ImGui::Button("Cancel")) {
            ImGui::CloseCurrentPopup();
            show_modal = false;
        }
        
        ImGui::EndPopup();
    }
}

​
Context Menu Popups

​
BeginPopupContextItem

bool ImGui::BeginPopupContextItem(const char* str_id = NULL, ImGuiPopupFlags popup_flags = 0)
Open+begin popup when clicked on last item. Use str_id==NULL to associate the popup to previous item.
​
str_id
const char*
default:"NULL"
Popup identifier (NULL = use last item’s ID)
​
popup_flags
ImGuiPopupFlags
default:"0"
Popup flags (default is right mouse button)
​
return
bool
True if popup is open
// Example
ImGui::Text("Right-click me for context menu");
if (ImGui::BeginPopupContextItem()) {
    if (ImGui::MenuItem("Copy")) { /* Do copy */ }
    if (ImGui::MenuItem("Paste")) { /* Do paste */ }
    if (ImGui::MenuItem("Delete")) { /* Do delete */ }
    ImGui::EndPopup();
}

// On a button
ImGui::Button("Button with context menu");
if (ImGui::BeginPopupContextItem("button_context")) {
    ImGui::MenuItem("Action 1");
    ImGui::MenuItem("Action 2");
    ImGui::EndPopup();
}

​
BeginPopupContextWindow

bool ImGui::BeginPopupContextWindow(const char* str_id = NULL, ImGuiPopupFlags popup_flags = 0)
Open+begin popup when clicked on current window.
​
str_id
const char*
default:"NULL"
Popup identifier
​
popup_flags
ImGuiPopupFlags
default:"0"
Popup flags
​
return
bool
True if popup is open
// Example
if (ImGui::BeginPopupContextWindow()) {
    if (ImGui::MenuItem("Clear Window")) { /* Clear */ }
    if (ImGui::MenuItem("Close Window")) { /* Close */ }
    ImGui::EndPopup();
}

​
BeginPopupContextVoid

bool ImGui::BeginPopupContextVoid(const char* str_id = NULL, ImGuiPopupFlags popup_flags = 0)
Open+begin popup when clicked in void (where there are no windows).
​
str_id
const char*
default:"NULL"
Popup identifier
​
popup_flags
ImGuiPopupFlags
default:"0"
Popup flags
​
return
bool
True if popup is open
// Example - Right-click in empty space
if (ImGui::BeginPopupContextVoid("void_menu")) {
    if (ImGui::MenuItem("Create New Window")) { /* Create */ }
    if (ImGui::MenuItem("Settings")) { /* Open settings */ }
    ImGui::EndPopup();
}

​
IsPopupOpen

bool ImGui::IsPopupOpen(const char* str_id, ImGuiPopupFlags flags = 0)
Return true if the popup is open.
​
str_id
const char*
Popup identifier
​
flags
ImGuiPopupFlags
default:"0"
Query flags
​
return
bool
True if popup is open
// Example
if (ImGui::IsPopupOpen("my_popup")) {
    ImGui::Text("Popup is currently open");
}

// Check if any popup is open
if (ImGui::IsPopupOpen("", ImGuiPopupFlags_AnyPopupId)) {
    ImGui::Text("Some popup is open");
}

​
ImGuiPopupFlags_

Flags for OpenPopup*(), BeginPopupContext*(), IsPopupOpen() functions.
FlagDescription
ImGuiPopupFlags_NoneDefault
ImGuiPopupFlags_MouseButtonLeftFor BeginPopupContext*(): open on Left Mouse release
ImGuiPopupFlags_MouseButtonRightFor BeginPopupContext*(): open on Right Mouse release (default)
ImGuiPopupFlags_MouseButtonMiddleFor BeginPopupContext*(): open on Middle Mouse release
ImGuiPopupFlags_NoReopenDon’t reopen same popup if already open
ImGuiPopupFlags_NoOpenOverExistingPopupDon’t open if there’s already a popup at the same level
ImGuiPopupFlags_NoOpenOverItemsFor BeginPopupContextWindow(): don’t return true when hovering items
ImGuiPopupFlags_AnyPopupIdFor IsPopupOpen(): ignore the ImGuiID parameter
ImGuiPopupFlags_AnyPopupLevelFor IsPopupOpen(): search/test at any level of the popup stack
// Examples

// Left mouse button popup
ImGui::Button("Left-click popup");
ImGui::OpenPopupOnItemClick("left_popup", ImGuiPopupFlags_MouseButtonLeft);

// Don't reopen
if (ImGui::Button("Open Once")) {
    ImGui::OpenPopup("once_popup", ImGuiPopupFlags_NoReopen);
}

// Middle mouse button
ImGui::Text("Middle-click me");
if (ImGui::BeginPopupContextItem("middle", ImGuiPopupFlags_MouseButtonMiddle)) {
    ImGui::MenuItem("Action");
    ImGui::EndPopup();
}

​
Advanced Examples

​
Confirmation Dialog

void ShowDeleteConfirmation() {
    static bool show_confirm = false;
    
    if (ImGui::Button("Delete Item")) {
        show_confirm = true;
        ImGui::OpenPopup("Delete?");
    }
    
    if (show_confirm) {
        ImVec2 center = ImGui::GetMainViewport()->GetCenter();
        ImGui::SetNextWindowPos(center, ImGuiCond_Appearing, ImVec2(0.5f, 0.5f));
        
        if (ImGui::BeginPopupModal("Delete?", NULL, ImGuiWindowFlags_AlwaysAutoResize)) {
            ImGui::Text("Are you sure you want to delete this item?");
            ImGui::Text("This operation cannot be undone.\n\n");
            ImGui::Separator();
            
            if (ImGui::Button("Delete", ImVec2(120, 0))) {
                // Perform delete
                ImGui::CloseCurrentPopup();
                show_confirm = false;
            }
            ImGui::SetItemDefaultFocus();
            ImGui::SameLine();
            if (ImGui::Button("Cancel", ImVec2(120, 0))) {
                ImGui::CloseCurrentPopup();
                show_confirm = false;
            }
            ImGui::EndPopup();
        }
    }
}

void ShowMenuPopup() {
    if (ImGui::Button("Show Menu")) {
        ImGui::OpenPopup("menu_popup");
    }
    
    if (ImGui::BeginPopup("menu_popup")) {
        ImGui::SeparatorText("Actions");
        if (ImGui::MenuItem("New", "Ctrl+N")) { }
        if (ImGui::MenuItem("Open", "Ctrl+O")) { }
        
        ImGui::Separator();
        if (ImGui::BeginMenu("Recent")) {
            ImGui::MenuItem("file1.txt");
            ImGui::MenuItem("file2.txt");
            ImGui::EndMenu();
        }
        
        ImGui::Separator();
        if (ImGui::MenuItem("Quit", "Alt+F4")) { }
        
        ImGui::EndPopup();
    }
}

​
Custom Positioned Popup

if (ImGui::Button("Positioned Popup")) {
    ImGui::OpenPopup("positioned");
}

ImVec2 button_pos = ImGui::GetItemRectMin();
ImVec2 button_size = ImGui::GetItemRectSize();

if (ImGui::BeginPopup("positioned")) {
    // Popup appears below the button
    ImGui::SetWindowPos(ImVec2(button_pos.x, button_pos.y + button_size.y));
    ImGui::Text("Positioned below button");
    ImGui::EndPopup();
}

​
Input Dialog Modal

void ShowInputDialog() {
    static bool show = false;
    static char input_buf[128] = "";
    
    if (ImGui::Button("Enter Name")) {
        show = true;
        ImGui::OpenPopup("Input Name");
    }
    
    if (show) {
        ImGui::SetNextWindowSize(ImVec2(300, 0));
        if (ImGui::BeginPopupModal("Input Name", &show, ImGuiWindowFlags_AlwaysAutoResize)) {
            ImGui::Text("Please enter your name:");
            ImGui::Separator();
            
            ImGui::SetKeyboardFocusHere();
            bool enter_pressed = ImGui::InputText("##name", input_buf, IM_COUNTOF(input_buf), ImGuiInputTextFlags_EnterReturnsTrue);
            
            ImGui::Separator();
            if (ImGui::Button("OK") || enter_pressed) {
                // Process input
                ImGui::CloseCurrentPopup();
                show = false;
            }
            ImGui::SameLine();
            if (ImGui::Button("Cancel")) {
                ImGui::CloseCurrentPopup();
                show = false;
            }
            
            ImGui::EndPopup();
        }
    }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us