How to Label Roads and Rivers in QGIS

Good labels make a map easier to read without competing with the features themselves. Roads and rivers are both line features, but they need different treatment. Road labels usually emphasize hierarchy, route names, and street readability. River labels usually use blue or blue-gray text, italic styling, and curved placement that follows the watercourse.

QGIS provides line-label placement modes, label repetition, anchoring, scale-based visibility, priorities, obstacles, data-defined settings, and manual label tools. The best result comes from combining those controls with a clear map scale and a well-structured name field.

Before labeling: inspect the line data

Open the attribute table for the roads or rivers layer and identify:

• The primary name field
• A short name or abbreviation field
• Feature class or hierarchy
• Route number or reference number
• River or watercourse type
• A display-language field, if applicable
• A field indicating unnamed or unknown features

Do not label a generic identifier unless it is meaningful to the map reader. A road layer may contain multiple segments with the same name, while a river may be split into many parts. The field you use for labels should be chosen with the map’s purpose and scale in mind.

Also inspect the geometry. Very short line segments may not be long enough to carry a label. Connected segments may repeat the same name. Multipart features can produce unexpected placements if they are labeled as one feature.

Enable labels in QGIS

There are two common ways to open the labeling controls:

From Layer Properties

1. Right-click the road or river layer.
2. Select Properties.
3. Open the Labels tab.
4. Change No Labels to Single Labels.
5. Select the field or expression to use as the label value.
6. Click Apply.

From the Layer Styling panel

1. Select View → Panels → Layer Styling if the panel is not visible.
2. Select the line layer.
3. Open the labeling controls.
4. Switch from No Labels to Single Labels.

The QGIS training manual uses the same basic workflow: select the layer, activate Single Labels, choose an attribute field, and then adjust text, buffer, placement, and rendering settings. 1

Create a clean label expression

Instead of selecting a raw field, use the expression button beside the label value. Expressions are useful when the data contains nulls, abbreviations, route numbers, or multiple name fields.

Hide blank and placeholder names

CASE
  WHEN "name" IS NULL OR trim("name") = '' THEN NULL
  WHEN lower(trim("name")) IN ('unnamed', 'unknown', 'null') THEN NULL
  ELSE trim("name")
END

Returning NULL prevents QGIS from drawing empty or meaningless labels.

Use a short name at smaller scales

CASE
  WHEN @map_scale > 100000 AND "short_name" IS NOT NULL
    THEN "short_name"
  ELSE "name"
END

Scale expressions should be tested at the actual map scales used in the layout. The exact threshold is not universal.

Add a route number

CASE
  WHEN "ref" IS NOT NULL AND "name" IS NOT NULL
    THEN "ref" || ' ' || "name"
  WHEN "ref" IS NOT NULL
    THEN "ref"
  ELSE "name"
END

Keep the expression readable. A map label is not a database record; adding every available attribute usually creates clutter.

Labeling roads

Recommended road-label style

A practical road style often uses:

• A legible sans-serif font
• Dark gray or black text
• A small light buffer or halo
• Regular text for minor roads
• A stronger weight or larger size for major routes
• Scale-dependent visibility
• Curved or parallel placement depending on the geometry and scale

The exact font size should be chosen in relation to the final output size, map scale, and printing or screen context. Fixed recommendations such as “all local roads should be 8 points” are only starting points.

Road-label workflow

1. Open the road layer’s Labels tab.
2. Choose Single Labels.
3. Select the road-name field or expression.
4. Set the font and color in Text.
5. Open Buffer and enable a subtle halo.
6. Open Placement and choose Parallel or Curved.
7. Open Rendering and set scale visibility or minimum feature size.
8. Review the map at the intended scale.

Parallel placement

Parallel placement draws the label along a generalised representation of the road. QGIS allows positions such as:

• Above the line
• On the line
• Below the line
• A line-orientation-dependent position

You can select more than one allowed position, allowing QGIS to search for a position that fits. You can also set the distance between the label and the line. 2

Parallel placement is often effective for straighter roads or maps where the road symbol needs to remain clearly visible beneath the text.

Curved placement

Curved placement follows the geometry of the road. It is useful for winding roads and larger-scale maps, but QGIS may omit a label when the line is too short or the bend is too sharp for readable text.

QGIS provides a Maximum angle between curved characters setting. A smaller maximum angle tends to favor readability but may suppress labels on highly curved features. A larger angle allows more labels but can produce awkward character rotations. Test the result rather than treating a particular value as a universal standard. 2

Merge connected road lines

A named road may be split into multiple connected segments. If every segment receives the same label, the map becomes repetitive. QGIS provides Merge connected lines under label rendering to help avoid duplicate labels for connected features. 3

Use this setting only when the connected segments genuinely represent the same named feature. Do not merge labels across different road names or classifications simply to reduce density.

Repeating labels on long roads

For a long highway or arterial, one label may not be enough. For a local street, repeated labels may be unnecessary.

Use Repeating Labels Distance in the line placement settings to control how far apart repeated labels appear. QGIS supports multiple distance units, including millimeters, points, pixels, meters at scale, and map units. 2

A good map usually repeats major routes sparingly and avoids repeating short residential street names unless the map is zoomed in.

Suppress labels on short road features

A short road segment may not have enough room for its name. In the Rendering tab, use Suppress labeling of features smaller than to prevent labels from appearing on features below a chosen rendered size. 3

This is often more effective than reducing the font until the text becomes unreadable.

Road hierarchy with rule-based labels

If your road layer has a class field, use separate rules for major highways, arterial roads, collectors, and local streets. Each rule can have its own:

• Label size
• Font weight
• Color
• Placement
• Visibility range
• Priority
• Repeat distance

For example:

• Major routes: larger, stronger labels, visible at smaller scales
• Arterials: medium labels, moderate priority
• Local streets: smaller labels, visible only when zoomed in
• Service roads: often unlabeled unless specifically needed

Use the field definition rather than assuming that a value such as 1, 2, or A has a universal meaning.

Route shields and road numbers

A route number is not always best displayed as plain text. If the map has a recognized road-shield convention, use a label background or SVG marker that matches the map’s visual language.

A simple expression can display a route number:

"ref"

A combined expression can show the number and name:

coalesce("ref" || ' ', '') || coalesce("name", '')

Use a separate layer or rule when the route number needs a shield-shaped background. Do not create a shield for every road classification without confirming the source attributes and cartographic convention.

Labeling rivers and watercourses

River labels need to communicate a natural feature without being confused with road or settlement labels. Common choices include:

• Blue or blue-gray text
• Italic or lightly slanted text
• Curved placement
• A subtle halo when the background is complex
• Larger or stronger text for major rivers
• Scale-dependent display for creeks and minor channels

A river name should normally be placed so the reader can tell which watercourse it describes. A label floating far from a meandering line may be visually attractive but ambiguous.

River-label workflow

1. Open the river layer’s Labels tab.
2. Choose Single Labels.
3. Select the documented name field.
4. Set a blue or blue-gray font.
5. Consider italic styling, but check readability at the final size.
6. Choose Curved placement for suitable line geometries.
7. Set a readable maximum character angle.
8. Adjust distance, anchoring, and repeat distance.
9. Use scale-dependent rules for rivers, streams, and drains.
10. Review the label direction and placement at several scales.

Curved labels for rivers

Curved placement is often useful because it follows the watercourse, but it is not automatically correct for every river geometry. Sharp bends, short segments, multipart features, and generalized lines can make labels disappear or become difficult to read.

QGIS allows line-label anchoring and clipping choices. You can place the label near the center, start, end, or a custom position along the line, and you can choose whether placement is calculated from the visible line extent or the whole feature extent. 2

For a river made of many segments, consider whether the data should be dissolved or whether the label should be controlled through rules or a curated label field. Do not dissolve the analytical river layer just to improve cartography without saving a separate display copy.

River hierarchy

Use the river classification field to separate:

• Major rivers
• Named tributaries
• Creeks and streams
• Canals and drains
• Intermittent or seasonal waterways

Major rivers can be labeled at smaller scales. Minor waterways usually belong at larger scales. If a feature is unnamed, hiding the label is normally better than showing a coded identifier.

Label direction and upside-down text

The direction of the line geometry affects the direction in which curved labels are constructed. The source geometry may have been digitized upstream-to-downstream, downstream-to-upstream, or in another direction.

QGIS provides controls for line direction symbols and the treatment of upside-down labels. The rendering options prioritize readable screen orientation by default, while more specialized workflows can allow or preserve data-defined rotations. 2 3

Do not reverse all river geometries automatically. Reverse a display copy only when you have a clear cartographic reason and understand the effect on line direction, arrows, flow analysis, and downstream processing.

Improve contrast with a text buffer

A label buffer creates a halo around the text. It is especially useful when labels sit over imagery, shaded relief, dense roads, or complex hydrography.

A practical starting style is:

• Small buffer width
• White or very pale fill for dark road text
• A light or transparent buffer for blue river text
• Moderate opacity
• No heavy shadow unless the background requires it

QGIS’s training material demonstrates enabling a text buffer to improve label readability over underlying map features. 1

A buffer should support the text, not become a visible outline that dominates the map.

Label priority and conflict handling

QGIS’s labeling engine decides which candidate labels to place when labels compete for space. In the Placement settings, the Priority value controls the relative importance of labels. A higher-priority label is more likely to be retained when candidates conflict. 3

A useful priority strategy is:

• Major highways and major rivers: high priority
• Secondary roads and tributaries: medium priority
• Local roads and minor streams: lower priority
• Informational or duplicate labels: lowest priority

Priority should reflect the map’s purpose. A flood map may prioritize watercourses differently from a road-navigation map.

Obstacles

A feature can act as an obstacle that discourages labels from being placed over it. QGIS allows obstacle behavior to be controlled for a layer and weighted so that some labels can still be placed over less important obstacles. 3

For example:

• A bridge or important road symbol may be a strong obstacle.
• A low-priority background feature may be a weak obstacle.
• A river polygon or waterbody may discourage labels from unrelated layers crossing it.

Avoid making every layer a strong obstacle. If too many features block labels, important names may disappear.

Overlapping labels

QGIS provides options to never overlap labels, allow overlaps only if necessary, or allow overlaps without penalty. 3

For most road and river maps, start with avoiding overlaps. If too many labels disappear, improve the hierarchy and scale rules before simply allowing all overlaps. A map where every feature is labeled is not necessarily more informative.

Label z-index

The label z-index controls label rendering order relative to other labels. It can help ensure that important labels appear above less important ones, but it does not place labels below the map features themselves. 3

Use z-index together with layer order, priority, and obstacles rather than relying on it alone.

Scale-dependent labeling

A road or river name that works at 1:10,000 may be impossible to read at 1:500,000. Scale-based visibility prevents the map from showing too much information at once.

A practical hierarchy might be:

• National or regional view: major highways and major rivers
• City or district view: arterial roads and named rivers
• Neighborhood view: local streets and streams
• Detailed view: minor roads, drains, and small named channels

Set scale visibility in the Rendering tab. Use the map’s final publication scales rather than arbitrary thresholds copied from another project.

For an atlas or web map, test several pages or zoom levels. A label that looks good in one extent can become misleading or crowded in another.

Data-defined label settings

Data-defined overrides allow label properties to vary by feature. You can set values such as:

• Font size
• Font weight or italic state
• Color
• Buffer size
• Priority
• Rotation
• Placement distance
• Show label
• Repeat distance
• Z-index

For example, a road font-size expression might be:

CASE
  WHEN "class" = 'motorway' THEN 12
  WHEN "class" = 'primary' THEN 10
  WHEN "class" = 'secondary' THEN 9
  ELSE 8
END

The field values must match the actual dataset. Test the expression with Preview in the expression builder and inspect unique values in the attribute table.

To hide labels for minor or unnamed features:

"name" IS NOT NULL
AND trim("name") <> ''
AND "class" IN ('major', 'primary', 'secondary')

Use manual label tools for final cartography

Automatic placement is efficient, but a final map may need a few manual adjustments. QGIS provides labeling tools for moving and rotating labels and for storing auxiliary placement information.

Use manual placement for:

• A major river near a confluence
• A highway label near a complex interchange
• A label that must avoid a title or inset map
• A long feature where the automatic anchor is visually weak
• A publication map with a small number of important labels

Keep the underlying geometry unchanged. Manual label placement should be treated as cartographic annotation, not as a modification of the road or river data.

Manage multipart and connected features

A multipart river or road may represent one named feature with several geometry parts. You can choose whether to label every part or limit labels to avoid repetition. QGIS also provides options for merging connected lines and limiting the number of features labeled. 3

Use these settings based on the data model:

• Label every part when each part is meaningful and needs identification.
• Label one representative position when the multipart feature is a single named entity.
• Dissolve only for a display copy when connected segments should behave as one cartographic line.

Common problems and fixes

Road labels appear too often

Enable Merge connected lines where appropriate, increase repeat distance, suppress labels on short features, or use scale-based rules. Check whether the road is split into many segments with the same name.

River labels disappear

The line may be too short, too curved, too fragmented, or blocked by other labels. Try Parallel placement, increase the allowable angle carefully, adjust the anchor, or use a curated display layer. Do not force all labels to overlap.

Labels are upside down

Check line geometry direction and the rendering setting for upside-down labels. Prefer readable screen orientation unless the map specifically requires preserving a direction value.

Labels are not following the line

Confirm that the layer is a line layer, select Parallel or Curved placement, and check whether the geometry is long enough for the label. Very short segments may not support curved placement.

Labels are unreadable over imagery

Use a text buffer, adjust color and opacity, reduce competing labels, and consider a lighter or darker basemap. A heavy shadow is not always the best fix.

Important labels are missing

Increase their priority, reduce competing labels, check scale visibility, check the feature-size suppression setting, and review obstacle weights. Avoid enabling every label overlap option as the first solution.

The label field is blank

Inspect nulls, whitespace, aliases, data types, and the expression. Use trim() and coalesce() where appropriate.

Labels are duplicated after dissolving or merging

Check whether the name field remains consistent across the dissolved features. Use Merge connected lines or a display-only generalized layer when appropriate.

A practical road-label recipe

For a city road map:

1. Create a rule-based labeling setup by road class.
2. Use a clear sans-serif font.
3. Apply a subtle light buffer.
4. Use Parallel placement for straighter roads and Curved placement for winding roads.
5. Merge connected lines for continuous same-name segments.
6. Suppress labels on short features.
7. Show major roads at smaller scales and local streets only when zoomed in.
8. Give important routes higher priority.
9. Add route numbers only where they improve navigation.
10. Test the map at the final output size.

A practical river-label recipe

For a hydrography map:

1. Separate major rivers, named tributaries, and minor waterways with rules.
2. Use blue or blue-gray text.
3. Use italic styling only if it remains readable.
4. Use Curved placement for suitable river geometries.
5. Set a conservative character-angle limit.
6. Adjust the label anchor along long or meandering rivers.
7. Avoid labeling unnamed features.
8. Use repeat distance sparingly.
9. Give major rivers higher priority than minor streams.
10. Check labels near confluences, bridges, and map boundaries.

Export and review

Before exporting a map:

• Confirm the intended scale.
• Check that names are correctly spelled.
• Ensure the label field and expression are documented.
• Review road and river hierarchy.
• Inspect crowded intersections and confluences.
• Check label orientation.
• Verify the buffer and color contrast.
• Confirm that labels are not clipped at the map frame.
• Review the PDF or image at its final display size.

Labels are part of the map design. A technically valid labeling configuration can still produce a poor map if it shows too many names, uses weak hierarchy, or ignores the reader’s task.

Frequently asked questions

How do I label roads in QGIS?

Open the road layer’s Labels tab, change No Labels to Single Labels, choose the road-name field, and configure Text, Buffer, Placement, and Rendering. Use Parallel or Curved placement for line features and apply scale-based visibility for different road classes.

How do I curve river labels in QGIS?

Open the river layer’s Labels tab, choose Single Labels, select the river-name field, open Placement, and select Curved. Adjust the maximum angle between curved characters, distance, anchor, and repeat settings. Short or sharply curved features may not receive a curved label.

Why are QGIS labels missing?

Labels can be omitted because of overlap conflicts, low priority, scale visibility, short geometry, curved-placement limits, obstacles, null names, or feature-size suppression. Inspect the Rendering and Placement settings before allowing all overlaps.

How do I stop QGIS from labeling every road segment?

Use Merge connected lines where segments have the same name, increase repeating-label distance, suppress short features, or create a display layer with appropriate geometry and name fields.

How do I set label priority in QGIS?

Open the layer’s Labels tab, go to Placement, and adjust Priority. Higher-priority labels are more likely to be retained when labels compete. Use this together with scale visibility and obstacle settings.

Should rivers always use italic labels?

Italic blue labels are a common cartographic convention, but they are not mandatory. Choose the style that remains readable and distinct from roads at the final scale.

How do I show road numbers and road names together?

Use a QGIS expression such as coalesce("ref" || ' ', '') || coalesce("name", ''), or create separate rules for route shields and road names. Check the source fields and intended map convention first.

Can I manually move QGIS labels?

Yes. Use the labeling toolbar’s move or rotate label tools and auxiliary placement fields where appropriate. Manual adjustments are useful for final cartographic polish and do not need to modify the road or river geometry.

How can I label only major roads or rivers?

Use a rule-based labeling condition or a Show Label expression based on the documented classification field. For example, filter the label expression with a condition that includes only major and primary classes.

Why do curved labels follow the river in the wrong direction?

The geometry direction may be reversed. Check the line direction and the settings for upside-down labels. Reverse a display copy only when appropriate, because line direction can affect other analyses and symbols.

Conclusion

Effective road and river labeling in QGIS is a combination of correct label fields, appropriate line placement, scale management, hierarchy, conflict handling, and visual review. Use Parallel or Curved placement for line features, Merge connected lines to reduce repetition, and scale-based rules to prevent clutter.

For roads, prioritize clear hierarchy and navigation. For rivers, prioritize natural placement, readable curvature, and a clear relationship between the label and watercourse. Use data-defined settings and manual placement for important features, but keep the original data separate from cartographic display adjustments.

A good label configuration does not try to show every name at every scale. It shows the names that matter for the reader’s task, in positions that are readable and visually connected to the correct feature.

References

[1] QGIS Training Manual: Labels

[2] QGIS User Guide: Label settings and line placement

[3] QGIS User Guide: Label priority, obstacles, rendering, and conflict handling