How to Build Custom Widgets and Dashboards

How to Build Custom Widgets and Dashboards

Prerequisites

  • Access to the Dashboard section
  • At least one integration connected with data
  • Dashboard Edit permission

    • Creating a Custom Dashboard

    Navigation: Sidebar → Dashboard → Custom Widget Builder

    Step 1: Access the Builder

  • Click Dashboard in the sidebar.
  • Click the option to create or edit a custom dashboard.
  • The drag-and-drop grid editor opens in edit mode.

    • Building Widgets

    Method 1: Visual Query Builder

    The visual builder lets you construct data queries without writing code:

    ComponentWhat It Does
    Table RelationsSelect which data tables to query
    JoinsConnect related tables for cross-data analysis
    AggregationsApply SUM, COUNT, AVG, MIN, MAX to fields
    Group ByGroup results by specific dimensions
    Order BySort results ascending or descending
    LimitCap the number of results returned

    Method 2: SQL Mode

    For advanced users:

  • Switch to SQL Mode in the query builder.
  • Write a direct SQL query against your security data.
  • Preview results before adding to the dashboard.

    • Method 3: AI-Assisted Query Generation

  • Switch to the AI tab in the query builder.
  • Describe what you want in natural language (e.g., "Show me the top 10 most vulnerable endpoints by severity").
  • The AI generates the SQL query for you.
  • Review and modify the generated query if needed.
  • Add to your dashboard.

    • > Tip: AI-assisted query generation is the fastest way to build widgets. Start with natural language, then refine the generated query in SQL mode if needed.

    Chart Types

    Select from 14+ visualization types:

    Chart TypeBest For
    Bar ChartComparing categories
    Line ChartTrends over time
    Pie ChartDistribution/proportions
    Donut ChartDistribution with center metric
    Area ChartVolume over time
    Scatter PlotCorrelation analysis
    TableDetailed data display
    Number/KPISingle key metric
    GaugeProgress toward a target
    HeatmapDensity/intensity patterns
    RadarMulti-dimensional comparison
    TreemapHierarchical data
    FunnelSequential process metrics
    Stacked BarCategory composition

    Customizing Appearance

  • Color picker — customize widget colors
  • Chart type change — switch visualization types after creation
  • Duplicate widget — copy an existing widget and modify

    • Dashboard Layout

  • Drag and drop widgets to rearrange the grid
  • Resize widgets by dragging their edges
  • Switch between edit mode and view mode
  • Dashboards auto-save layout changes

    • Standard KPIs (Pre-Built Widgets)

    Interno includes 14+ pre-built KPI widgets:

  • Compliance Score, Breach Probability, Z-Score Analysis
  • Patches Heap, Mitigation Efficiency, Risk Posture Trend
  • Upcoming Audit, Budget Analysis, Security Program Maturity
  • Risk Tolerance/Appetite, Privileged Access Anomalies
  • MFA Coverage Gaps, Data Exfiltration, Unmanaged Asset Growth

    • Troubleshooting

    IssueSolution
    No data in widgetVerify your integrations are connected and syncing. Check the query targets the correct data tables.
    SQL query failsCheck syntax. Use the visual builder to validate the correct table and column names.
    AI-generated query is incorrectRefine your prompt with more specific details. Review and edit the generated SQL.
    Cannot save dashboardEnsure you have Dashboard Edit permission. Check for unsaved widget configurations.