Troubleshooting Visual Artefacts in QGIS Layout Manager
The QGIS Layout Manager is a powerful tool for cartographic composition, yet it is susceptible to "artefacts"—visual glitches like ghosting, flickering map items, or missing tiles that appear in the workspace but not always in the final export. These issues often stem from a conflict between the Qt Graphics Framework, your GPU's hardware acceleration, and the way QGIS manages its internal cache for high-resolution layers. Unlike data-driven errors, these are rendering bugs that can stall production. This guide outlines the technical steps to clear your canvas of ghosting and ensure what you see in the layout is exactly what gets printed.
Table of Content
- Purpose of Artefact Resolution
- Common Use Cases
- Step by Step: Clearing Layout Glitches
- Best Results for Export Fidelity
- FAQ
- Disclaimer
Purpose
The primary purpose of this tutorial is to stabilize the WYSIWYG (What You See Is What You Get) experience in QGIS. Visual artefacts can lead to misaligned legend items, incorrectly scaled scale bars, or "phantom" layers that appear as black boxes. By adjusting Rendering Settings and Anti-aliasing toggles, we can eliminate the feedback loops that cause these screen-space errors, ensuring a clean and professional cartographic workflow.
Use Case
Identifying and fixing layout artefacts is essential for:
- High-Resolution Map Production: Preventing "tiling lines" or seams in large-format maps (A0 or larger).
- Vector-Heavy Layouts: Fixing the "stuttering" or ghosting that occurs when moving map items over complex SVG symbols.
- Hardware-Accelerated Environments: Resolving conflicts in workstations using dedicated NVIDIA or AMD GPUs where the GUI might "tear."
- Print-Ready Deliverables: Ensuring that transparency effects and blending modes render correctly in the final PDF/TIFF.
Step by Step
1. Disable Hardware Acceleration
Most layout artefacts are caused by OpenCL or hardware acceleration mismatches.
- Navigate to Settings > Options > Acceleration.
- Uncheck "Enable OpenCL acceleration."
- Restart QGIS to see if the flickering in the Layout Manager persists.
2. Refresh the Layout Buffer
If you see a "ghost" of a deleted layer, you need to force a redraw.
- In the Layout Manager window, click the Refresh (circular arrow) icon in the toolbar.
- Alternatively, toggle the visibility of the "Map 1" item in the Items Panel to clear the internal cache.
3. Adjust Map Item Rendering
For complex vector data, the layout might struggle with anti-aliasing.
- Select your Map Item.
- In the Item Properties tab, scroll down to Rendering.
- Experiment with toggling "Enable back-buffer" or adjusting the Update Interval.
4. Configure PDF Export Settings
If the artefacts only appear in the exported file:
- When exporting as PDF, ensure "Always export as vectors" is checked for sharp lines, OR "Export as raster" if you are using complex blending modes that cause PDF viewer glitches.
- Check "Simplify geometries to reduce output file size."
5. Rebuild the QGIS Profile
Persistent artefacts can be caused by a corrupt user profile.
- Go to Settings > User Profiles.
- Create a "New Profile" and test the layout. If the artefact is gone, the issue was a corrupted setting or plugin in your main profile.
Best Results
| Artefact Type | Primary Cause | Success Strategy |
|---|---|---|
| Black Box/Missing Tiles | VRAM Overflow | Reduce Export DPI or turn off OpenCL |
| Flickering Labels | Label Engine Collision | Lock Layers/Styles in Layout Item |
| PDF Color Shift | Color Space Mismatch | Force CMYK or RGB export in Profile |
FAQ
Why do my lines look jagged in the Layout Manager but fine in the Map View?
This is often due to the Screen Resolution (DPI) scaling of the layout. The layout uses a preview resolution to save memory. To see the true quality, use the Zoom to 100% button in the Layout toolbar.
Does QGIS 3.34+ handle layout memory differently?
Yes. Newer versions have optimized the way Map Canvas is cached for layouts. If you are experiencing major artefacts, upgrading to the latest Long Term Release (LTR) is often the most direct fix.
Can third-party plugins cause layout artefacts?
Absolutely. Plugins that alter the rendering pipeline (like some heat-map or terrain generators) can leave data in the buffer. Disable all non-core plugins if the issue persists across all projects.
Disclaimer
Rendering artefacts can be highly specific to your OS (Windows, macOS, or Linux) and driver version. This tutorial is designed for QGIS 3.x and above, as of early 2026. Always ensure your GPU drivers are up to date before attempting deep-level software reconfigurations. Back up your Project (.qgs) file before deleting user profiles or resetting global settings.
Tags: QGIS, Cartography, LayoutManager, GISBugs
