General Information
Testing your game and UI across multiple devices, aspect ratios, and pixel densities can be an incredibly tedious process. The OG Device Preview Pro is an editor workflow plugin designed to speed up your cross-platform development.
It allows you to instantly resize your Play-In-Editor (PIE) window and UMG Widget Designers using customizable shortcuts. Whether you are targeting phones, tablets, or standard desktop monitors, this plugin mathematically replicates Unreal Engine’s native device scaling rules to give you a pixel-perfect preview every single time. Stop guessing how your game looks on different screens and start testing with a single click!
Setup
Step 1: Add the Plugin Install the OG Device Preview Pro plugin to your engine via the Epic Games Launcher.
(Step 2: Clear the Config Cache; Only needed if it doesn’t work without) Because the plugin injects a massive library of custom device profiles and resolutions into your project, you sometimes need to clear the projects config cache once.
Close your Unreal Engine project.
Navigate to your project folder in the Windows File Explorer.
Delete the
Saved/Configfolder (e.g.,YourProject/Saved/Config).Reopen your project. The engine will now cleanly rebuild the configs and load all new device presets.
Step 3: Enable the Plugin Open your project, go to Edit > Plugins, search for “OG Device Preview Pro”, and ensure the checkbox is enabled.
Step 4: Configure Your Shortcuts
Navigate to Edit > Editor Preferences.
Scroll down to the Plugins section on the left panel and select OG Device Preview Pro.
Under the Entries array, click the “+” icon to add a new device shortcut.
Select a device from the Preset dropdown or switch to Custom and set the width and height values.
Assign your preferred Shortcut Key (e.g.,
F1 or Ctrl + F1).
Step 5: Start Testing! You are all set! Open a UMG Widget or launch the game in the New Editor Window mode and press your assigned shortcut. The window and your Widget Designers will instantly scale to the exact resolutions.
Troubleshooting & Known Issues
Even with a perfect setup, you might encounter some engine-specific quirks. Here is how to fix them:
PIE Window grows in size after exiting (Unreal Engine Bug)
The Issue: If the display scaling in your Windows OS Settings is set to anything other than 100%, you might notice that your PIE (Play-In-Editor) window slightly increases in size by a few pixels every time you exit and restart the play session. This is a known, long-standing Unreal Engine bug (Read more about it on the Unreal Engine Forums).
The Fix: 1. Go to your plugin settings (Edit > Project Settings > OG Device Preview Pro). 2. Open your Resolution Entry. 3. Check the “Center On Screen” checkbox. This forces the plugin to recalculate and perfectly center the window, completely bypassing the Unreal Engine bug!
My Shortcuts are triggering other Editor features
The Issue: You assigned a hotkey (e.g., Ctrl + B), but instead of resizing the preview, it opens the Content Browser.
The Fix: Ensure that the “Consume Matching Shortcuts” checkbox is enabled in the General Settings of the plugin. This tells the plugin to intercept the key press and prevent other default editor actions from firing simultaneously.
The Preset Dropdown is empty or missing devices
The Issue: The plugin relies on injected INI configuration files. If the engine didn’t load them properly during the first launch, the list might appear empty.
The Fix: Close your Unreal Engine project entirely. Navigate to your project directory, delete the ProjectName/Saved/Config folder, and launch the project again.
Version Changes
V1.0
Initial Launch version.