Use Memory Snapshot to capture a snapshot of memory usage from a connected client during a play session. Memory Snapshot displays a breakdown of estimated memory usage across assets loaded on your island, helping you identify which assets are consuming the most memory and impacting performance.
Use Memory Snapshot to:
Investigate high memory usage
Review memory impact across asset types
Track down assets contributing to performance issues
Navigate directly to referenced assets within your project
Spatial Profiler visualizes performance and memory data across the island, while Memory Snapshot provides a detailed breakdown of the assets contributing to memory usage.
Using Memory Snapshot
You can open Memory Snapshot from either the Performance panel or directly from the Spatial Profiler.
If your island exceeds memory usage thresholds during a play session, a memory warning notification appears in UEFN. The notification includes a button to open Memory Snapshot.
Memory Snapshot currently supports locally launched PC clients only.
Spatial Profiler metrics can still be collected from connected mobile clients, but Memory Snapshot insights are unavailable for Mobile, Remote PC, and Console client play sessions.
Enable Monitor Performance
To use Memory Snapshot, enable Monitor Performance from the Launch Session menu before launching a play session. Monitor Performance tracks island memory usage during gameplay.
Open Memory Snapshot from Performance Panel
In the bottom panel of the UEFN window, click Performance.
Select Memory Snapshot.
The Memory Snapshot window opens and connects to the active client session.
Open Memory Snapshot from Spatial Profiler
If the Spatial Profiler is already open, click Take Memory Snapshot to open the Memory Snapshot window and capture a snapshot from the connected client.
This workflow is useful when investigating memory spikes or performance warnings detected during profiling.
Open Memory Snapshot from the memory warning notification
If your island exceeds memory usage thresholds during a play session, a memory warning notification appears in UEFN.
Click Memory Snapshot from the notification to open the Memory Snapshot window for the active client session.
Capture Types
Memory Snapshot supports two capture types depending on how detailed you want the snapshot to be.
To view the capture types, click the options menu next to Take Memory Snapshot.
Capture Types | Description |
Detailed Insight (Default) | Captures a complete memory snapshot including total resource size for assets and references. This option provides the most detailed memory information and is recommended for most memory investigations. Enabled by default. |
Quick Insight | Capture a quick memory snapshot while skipping recursive resource size calculations. This option generates results faster, but provides less thorough memory information. |
Review Memory Usage
After a snapshot is captured, the Memory Snapshot window displays a breakdown of estimated memory usage for loaded assets within the connected client session.
Snapshots represent currently loaded assets only.
The snapshot includes:
Estimated memory usage
Asset impact percentages
Reference counts
Asset hierarchy information
Referenced asset relationships
Use this information to identify assets with:
High memory usage
Large project impact
Unexpected references
Excessive resource usage
Refresh Memory Data
Memory usage information may not immediately refresh after updating or removing assets during a play session.
If your changes require Push Changes, pushing updates refreshes the connected session and updates the Memory Snapshot data.
When testing Verse logic, devices, or gameplay systems, restarting the session before capturing another Memory Snapshot can help produce more accurate results. Restarting the session clears unused objects from memory and refreshes the session before capturing a new snapshot.
Memory Snapshot Window
The Memory Snapshot display is divided into multiple panels that help organize and investigate memory usage information.
You can dock the Memory Snapshot window within your UEFN workspace for quicker access.
Toolbar
The toolbar contains controls used to capture and manage Memory Snapshot insights.
Control | Description |
Take Memory Snapshot | Captures a new memory snapshot from the connected client. |
Hide External Objects | Hides objects that are external to the current project. Assets that are not visible are not included. |
Client Name | Displays the connected client name. |
Snapshot Timestamp | Displays when the snapshot was captured. |
Estimated Memory Breakdown Bar
The Estimated Memory Breakdown Bar displays a visual breakdown of estimated memory usage across object categories in the hierarchy.
Each section of the bar represents a portion of total estimated memory usage based on the currently displayed object tree.
Use the breakdown bar to quickly identify:
Large asset categories
Memory-heavy object groups
Areas worth investigating further
Search and Filter Controls
Use the search bar to locate specific assets or object names within the snapshot.
The Filter menu contains additional options for refining the displayed results.
Filter Option | Description |
Hide objects External to the Project | Hides objects that are not part of the current project. Enabled by default. |
Hide objects with No Referencing Actors | Hides objects that are not referenced by any Actor. Enabled by default. |
Hide objects with No Estimated Memory | Hides objects with no estimated system or video memory usage. Enabled by default. |
Hide objects with Low Estimated Memory | Hides objects with exclusive estimated memory usage below 1 Mb. |
Hide objects with Low Impact | Hides objects with an impact percentage below 1%. |
These filters help reduce visual clutter and focus the snapshot on assets with the largest impact on island memory usage.
Object Hierarchy Panel
The Object Hierarchy Panel displays project objects in a categorized tree view.
Objects are grouped into categories such as:
Uncategorized
Texture
Static Mesh
Material Instance
Material Instance Dynamic
Material
Each category expands the hierarchy and displays individual objects associated with that asset type.
Hierarchy Columns
Use these columns to compare assets and identify objects with large memory impact or excessive references.
Sorting by Estimated Size or Impact can help identify assets with high memory usage quickly.
The Object Hierarchy Panel contains the following columns:
Column | Description |
Hierarchy | Displays project objects and assets organized in a hierarchical list view. Right-click an asset entry in the Hierarchy column to access additional options, including Expand Subtree, Expand Critical Path, copy options, and export options for saving visible or complete hierarchy data to a file. |
Estimated Size | Displays the estimated memory usage for both system memory (RAM used by CPU) and video memory (memory used by the GPU), in Mb. |
Impact | Displays the percentage impact on estimated memory usage. |
References | Displays the number of asset references. |
Hover over a column header to display additional column options. The column menu includes ascending and descending sorting, column visibility settings, additional column types, and layout reset options for customizing the hierarchy view.
Asset Details Panel
Selecting an object from the hierarchy displays additional asset information in the Asset Details Panel.
The panel displays:
Asset name
Asset preview image
Estimated memory size
Reference information
Reference By relationships
The Reference By section displays where the selected asset is referenced within the project.
This information can help identify:
Unexpected dependencies
Duplicate usage
Assets contributing heavily to memory usage
Navigate to Referenced Assets
The Asset Details Panel includes a navigation button next to referenced assets.
Clicking the navigation button opens the actor referencing the selected asset within the project, helping you investigate where the asset is being used and identify potential sources of high memory usage.
Use this workflow to:
Locate assets with high memory usage quickly
Review asset setup
Optimize textures or meshes
Investigate unintended references