How Telegram Mini App Full-Screen Mode Works: Landscape Gaming, Desktop Scaling & Immersive Viewport APIs
Experience console-grade games, widescreen data dashboards, and interactive creative tools directly within Telegram. Explore Telegram Mini Apps' Full-Screen Mode with horizontal landscape orientation lock, desktop edge-to-edge scaling, and zero-distraction UI viewports.
Mini apps can lock screen rotation to horizontal 16:9 widescreen, enabling immersive RPGs, racers, and complex spreadsheets.
Supported seamlessly across Telegram Desktop on Windows, macOS, and Linux with resizable window viewports and keyboard hotkeys.
Direct access to device accelerometers, gyroscopes, and WebGL GPU acceleration for zero-lag native gaming performance.
rocket_launch Overview: The Evolution From Bottom Sheets to Immersive Canvases
developer_mode Developer Architecture: Full-Screen & Orientation SDK Methods
telegram-web-app.js SDK. Two primary methods handle full-screen lifecycle events:
// Check SDK support and trigger edge-to-edge full-screen
if (window.Telegram.WebApp.isVersionAtLeast('7.10')) {
// Request full-screen expansion
window.Telegram.WebApp.requestFullscreen();
// Lock orientation to landscape for games or video tools
if (window.Telegram.WebApp.lockOrientation) {
window.Telegram.WebApp.lockOrientation('landscape');
}
}
// Event listener for viewport status changes
window.Telegram.WebApp.onEvent('fullscreenChanged', function() {
console.log('Is Fullscreen:', window.Telegram.WebApp.isFullscreen);
});
// Safe Area Inset Handling for iOS Dynamic Island & Android Notches
const safeInsets = window.Telegram.WebApp.safeAreaInset;
document.body.style.paddingTop = safeInsets.top + 'px';
document.body.style.paddingBottom = safeInsets.bottom + 'px';devices User Experience Across Mobile & Desktop Platforms
iOS Experience (iPhone & iPad)
Launching a full-screen mini app hides the navigation bar. If the app requests landscape mode, rotating your iPhone automatically re-flows the UI without showing browser navigation bars or Safari chrome. Tapping the three dots (…) in the corner or swiping down from the edge reveals standard Telegram quick controls.
Android Hardware-Accelerated Viewport
On Android devices with 120Hz displays, full-screen Mini Apps leverage Chromium-powered GPU rendering. The navigation pill disappears, giving your web application 100% of the OLED display. Haptic vibration feedback and gyroscope steering function natively.
Desktop & Web Scaling (PC & Mac)
On Telegram Desktop, mini apps open in standalone resizable windows. Clicking the maximize icon expands the app to fill your primary or secondary 4K monitor. Keyboard events (WASD, Spacebar, Arrow keys) map directly without browser shortcut conflicts.
compare Bottom Sheet vs Full-Screen Mode Comparison
| Capability | Standard Bottom Sheet | Full-Screen Mode | Impact on User Engagement |
|---|---|---|---|
| Aspect Ratio | Fixed Portrait (Vertical) | Portrait & Landscape (16:9 / 21:9) | Essential for action gaming & videos |
| Screen Real Estate | 70% – 85% of display | 100% Edge-to-Edge | Zero visual distraction |
| Hardware Sensors | Standard Touch | Accelerometer, Gyroscope & Motion | Motion-steered driving & balance games |
| Desktop Support | Fixed modal dialog | Full desktop window maximization | Seamless productivity on PC/Mac |
| Status Bar Overlap | Reserved padding | Dynamic safeAreaInset integration | Clean, modern aesthetics |
Toggle between portrait and full-screen landscape orientations to preview how mini apps adapt to responsive dimensions.
help Frequently Asked Questions
Yes. Telegram maintains strict user experience safeguards. In full-screen mode, a discreet collapse pill is available in the corner, and swiping inwards from the screen edge or tapping the system back button instantly restores the standard chat window.
Yes, but only with explicit user permission. If a full-screen mini app requires camera or microphone input (for AR games, QR scanning, or voice chat), Telegram prompts the user with an explicit native system permission modal first.
Yes. Full-Screen Mode and orientation locking are supported across iOS, Android, and official Telegram Desktop applications running the latest client versions.
