# ChoroplethSVG Visualization Guide

**Component Reference:** ChoroplethSVG or @splunk/visualizations/ChoroplethSvg

## Overview

A choropleth SVG can be used to represent values within predefined regions with color. It is great for showing spatial data. Any custom Scalable Vector Graphic (SVG) image can be used. Use a choropleth SVG to display contextual data in objects, maps, or other custom shapes.

## Details

- **Category:** Spatial

## Tips

- Use a legend to help viewers understand the meaning of the colors in the SVG.

## Variations

| Variation | Description | Key |
| --- | --- | --- |
| Coloring By Gradient | Use gradient coloring to convey ordinal, quantitative data in choropleth images. | colorByGradient |
| Coloring By Range Value | Use range value coloring to convey numeric thresholds. | colorByRangeValue |
| Coloring By Match Value | Use match value coloring to convey specific numeric or string values. | colorByMatchValue |
