Fundamentals
pyqgis.com
Four core paths to learn PyQGIS
Focus your learning with dedicated guides for PyQGIS fundamentals, spatial automation, cartographic visualization, and QGIS plugin development.
qgis_project.pyEPSG:3857
processing.run("native:buffer", params)layer.renderer().symbol().setColor(color)PyQGIS is the Python interface to QGIS. Eighty-five in-depth guides across four core topics let you choose a path that matches your current goal — setting up a reliable environment, automating spatial processing, styling maps in code, or building and shipping plugins.
Automation
Spatial Data Processing & Automation
Build repeatable vector and raster workflows, use processing algorithms with confidence, and scale geospatial work beyond manual desktop steps.Open learning pathCartography
PyQGIS Cartography & Data Visualization
Style layers in code, build categorized and graduated thematic maps, label features, and turn analysis into publication-ready cartography.Open learning pathPlugins
QGIS Plugin Development
Design, structure, and ship QGIS plugins with PyQGIS and Qt, from lifecycle basics through packaging and publishing workflows.Open learning pathStart here
Popular guides across the site
Hand-picked walkthroughs that show PyQGIS in action — dip into any of them, or work through a full topic from its overview page.
- Fundamentals
QGIS Python Console Basics
Run PyQGIS interactively, reach your layers, and prototype scripts in seconds. - Automation
Batch Processing with PyQGIS
Run algorithms across many datasets, isolate errors, and automate repetitive GIS work. - Automation
Coordinate Reference Systems
Assign, transform, and validate CRS so your data always lines up on the map. - Cartography
Programmatic Layer Styling
Configure renderers, symbols, and data-defined overrides entirely from code. - Plugins
QGIS Plugin Boilerplate & Structure
Wire up metadata.txt, classFactory, initGui, and unload for a well-formed plugin. - Plugins
Qt Designer for Plugin Interfaces
Build .ui files, load them at runtime, and wire signals to your PyQGIS logic.
Newest guides
Recently added topic areas
Five new areas covering the expression engine, geometry and attribute work, canvas rendering, and interactive plugin tooling.
- Fundamentals
Working with QGIS Expressions
Evaluate expressions from Python, drive styling with them, and add your own functions. - Automation
Geometry Operations & Spatial Predicates
Buffer, overlay and measure geometry, and speed joins up with a spatial index. - Automation
Attribute Tables & Field Management
Add and drop fields, update values in bulk, join tables, and export a clean CSV. - Cartography
Map Canvas Control & Image Export
Drive the canvas, render maps headless, and export at a predictable size and DPI. - Plugins
Custom Map Tools & Canvas Interaction
Handle clicks and drags, draw rubber-band feedback, and react to project signals.
Suggested learning flow
Build confidence from setup to shipping tools
- Start with fundamentals and environment setup
- Move into automated spatial processing workflows
- Style and label maps in code for publication
- Build practical plugin interfaces and tooling
- Apply patterns to real project datasets