QGIS Tutorial for Beginners: Your First Map, Start to Finish
By the Osm4People editorial team
Photo: Monstera Production / Pexels
QGIS is the free, professional geographic information system that runs on Windows, Mac, and Linux, and it is where most people who make their own maps begin. This tutorial takes you from nothing installed to a finished, exported map with a title, a legend, and your own data on it. No sample files are needed from anywhere else: the dataset is a five-row table printed in this article, small enough to type by hand, which is deliberate. Typing the data yourself teaches you the one idea all of GIS rests on: a map is a table, drawn.
Work alongside the build checklist on this page and tick each stage off as you finish it. If you are brand new to the whole idea of GIS, our GIS for beginners roadmap explains where this tutorial fits in the larger path; if you already know you want maps, start here and learn by making one.
Interactive tool
First Map in QGIS: Build Checklist
Check off each step as you finish it. Your progress stays on this page.
0 of 9 complete
0% done
Step 1: Install the Right Version
Go to qgis.org and download the long-term release, marked LTR. QGIS publishes a fresh feature release often and maintains one stable LTR version for a year; beginners should always take the LTR, because tutorials, plugins, and answers online match it, and because stability matters more than novelty when you are learning. Install it the ordinary way for your system and open it. The first window looks busy. That is normal, and the next step names the only four parts you need today.
Step 2: The Window in Four Parts
The canvas is the big area in the middle: your map itself. The Layers panel, usually at the left, lists every dataset in the project, stacked like transparent sheets; the canvas draws them bottom to top. The toolbars across the top hold the buttons; today you need perhaps six of them. The status bar along the bottom quietly shows the coordinates under your cursor and the map's scale, and it is worth watching from the first minute, because it turns the canvas from a picture into a place. Everything else in QGIS, and there is a great deal, can be ignored until your second project.
Step 3: Start a Project and Add the World
Start a new project from the Project menu. Now give yourself the world as a base: in the Browser panel, find XYZ Tiles, expand it, and double-click OpenStreetMap. A street map of the whole planet appears on the canvas. This basemap is the same community-drawn data behind our guide to how to add a place to OpenStreetMap, served here as pictures for you to draw over. Zoom to a world view you like. Save the project now, in a folder you will keep, and save again after every stage that works; QGIS projects remember your layers and styling, and losing an hour to an unsaved project is a rite of passage you are allowed to skip.
Step 4: Type the Dataset
Open any plain text editor or spreadsheet and create this table, exactly, with the header row:
name
latitude
longitude
Statue of Liberty
40.689167
-74.044444
Eiffel Tower
48.858222
2.294500
Sydney Opera House
-33.856784
151.215297
Tokyo Skytree
35.710100
139.810700
Table Mountain
-33.962800
18.409800
Every pair in the table is one of this site's verified worked examples, restyled with the same code that powers the tools on this page. Save the file as places.csv. If you use a spreadsheet, export or save as CSV, comma separated, and make sure the numbers keep their minus signs and decimal points; a spreadsheet that helpfully reformats them is the first data bug most beginners ever meet, and it is easier to catch in the text file than on the map. What you have just made, though it looks humble, is a genuine geographic dataset: five records, each with attributes (the name) and a position (the pair). That sentence describes nearly everything a GIS ever holds.
Step 5: Add the CSV as a Layer
In QGIS, open the Layer menu, Add Layer, Add Delimited Text Layer. Choose places.csv. The dialog now asks the question this whole tutorial turns on: which columns hold the geometry? Set the X field to longitude and the Y field to latitude. Say it the way professionals remember it: X is the horizontal axis, and longitude runs horizontally; Y is vertical, and latitude runs vertically. Set the geometry CRS to EPSG:4326, WGS 84, the standard latitude and longitude system your numbers are written in. Click Add, then Close.
Five points appear on the basemap, one on each landmark. Zoom to each and look: the statue in its harbor, the tower in its city, the opera house on its point. You have made a map layer. Everything else in this tutorial is presentation.
The Two Traps, at the Exact Step Where They Bite
Trap one: swapped columns. If your points landed in the ocean, most famously in a neat pattern in the southern seas, you set X to latitude and Y to longitude. QGIS drew faithfully what you told it: a latitude of 151 is impossible, so the software quietly did strange things. Remove the layer and add it again with X as longitude. Nearly every GIS beginner on Earth has produced the ocean map once; producing it in a tutorial, where the fix is one paragraph away, is the cheapest tuition available.
Trap two: the wrong CRS. A coordinate reference system is the rulebook that says what your numbers mean. Your CSV numbers are degrees in WGS 84, EPSG:4326. If a layer is declared in some other system, QGIS will place it by that system's rules and your points can land continents away or collapse into a dot. The defense is a habit: every time you add data, ask what CRS the numbers are in, and declare exactly that. Data downloaded later in life, from our how to download OpenStreetMap data guide or anywhere else, will test this habit constantly.
A person works on charts and data analysis on a laptop
Step 6: Style the Points
Right-click the places layer and open Properties, then Symbology. Your five points currently wear the default marker. Choose a color that reads against both city streets and ocean, a strong red or orange, and raise the size until the points are visible at world zoom without shouting at street zoom. Click OK and look at the canvas with honest eyes: a map is communication, and this step, not the data step, is where most maps quietly succeed or fail. While you are learning, copy the restraint of good published maps: one accent color for your data, and let the basemap stay gray and quiet beneath it.
Step 7: Turn On the Labels
In the same Properties window, open Labels and switch from No labels to Single labels, with the value set to the name field. Set a readable size and, under the text options, add a thin white buffer or halo around the letters; that one setting is the difference between labels that vanish over busy streets and labels that float above them. Your five names appear beside their points. The map can now be read by someone who is not you, which is the definition of a map being finished rather than merely made.
Step 8: Build the Print Layout
A canvas on a screen is a working view; a layout is the map you hand to the world. Open Project, New Print Layout, and give it a name. Use Add Item, Add Map to draw a rectangle, and the canvas view appears inside it. Then add the furniture every finished map owes its reader:
A title that says what the map shows: Five Landmarks, Plotted From a Five-Row Table works.
A legend, added with Add Item, Add Legend, trimmed to your places layer.
A scale bar, because a map without a scale is a picture with ambitions.
A north arrow, from the picture items, so orientation is never a guess.
An attribution line in small text: OpenStreetMap contributors, because the basemap is their work and the credit is a condition of using it.
Arrange them the way you would arrange a page of a book: title at the top, map commanding the middle, legend and scale where the eye lands last. Nothing overlaps, nothing touches the edges.
Step 9: Export and Inspect
Use the layout's Export as PDF button, or Export as Image for a PNG. Open the exported file full screen and inspect it like a stranger: Can you read every label? Does the title say what this is? Could someone measure a distance from the scale bar? Is the attribution present? This inspection is a professional habit disguised as a pause; most published map errors are caught at exactly this moment, by exactly this look. Save the project one last time.
Where to Go Next
You now own the complete GIS loop in miniature: data in a table, a layer on a base, styling, labels, layout, export. Real projects differ only in scale and in the questions asked. Natural next steps: download real OpenStreetMap data for your own town with how to download OpenStreetMap data and plot a layer that matters to you; style the places layer by hemisphere with two colors, which teaches rule-based styling; and add a second dataset, any CSV of your own, because joining your own life to the map is when the tool becomes a habit. The sequenced path through all of it is GIS for beginners.
The Concepts You Just Used Without Noticing
It is worth naming what your hands already know. You worked with layers: independent datasets stacked in a chosen order, the single most important idea in GIS. You worked with attributes: the name column rode along with each point and became the labels, and any column you add, a country, a height, a date visited, becomes available for styling and filtering the same way. You met vector data, points defined by coordinates, as opposed to the raster pictures of the basemap. And you made the professional's distinction between the working canvas and the published layout. Every advanced thing QGIS does, spatial joins, buffers, heatmaps, terrain analysis, is a combination of those four ideas at larger scale. When a later tutorial uses the vocabulary, it is describing furniture you have already touched. The one idea deliberately postponed is projections, the mathematics of flattening the Earth; your project used the web's default for display, and the day a printed map of a large country looks subtly wrong is the day to learn it, not before.
Related Guides
The closest companions to this guide are the GIS and open map data guides below. Each one picks up a thread this page starts:
Yes, completely: QGIS is open source software, free to download and use for any purpose, including professional and commercial work. It is maintained by a global community and funded by donations and supporting members. There is no trial, no watermark, and no paid tier hiding the export button.
Which version of QGIS should a beginner install?
The long-term release, marked LTR on the download page. It is the stable version that tutorials and plugins target, and it is supported for a year. The newest feature release is for people who need a specific new capability.
My points landed in the ocean. What went wrong?
Almost certainly the X and Y fields are swapped. X must be longitude and Y must be latitude. Remove the layer, add it again with the fields corrected, and the points will stand on their landmarks. If they instead collapse or land on the wrong continent, check the CRS is EPSG:4326.
What is a CRS and why does QGIS keep asking?
A coordinate reference system is the rulebook that defines what a pair of numbers means: which zero lines, which units, which model of the Earth. Your CSV uses degrees in WGS 84, EPSG:4326. Declaring the CRS correctly is what lets QGIS stack data from different sources in the right places.
Can QGIS open the files from OpenStreetMap downloads?
Yes. QGIS opens osm.pbf extracts and other common formats directly or with its built-in tools, which is why the download guide on this site pairs naturally with this tutorial: download a town, open it in QGIS, and style it the way you styled your five points.
I finished the map. How do I know it is good?
Run the stranger test from Step 9: title that states the subject, every label readable, a scale bar, a legend that matches the symbols, a north arrow, and attribution for the basemap. A map that passes those six checks is a finished map by any newsroom or classroom standard.
Photo credits: Monstera Production (Pexels); ThisIsEngineering (Pexels). Photos are served from this site; follow the credit to the library page for the original.