For those who may not know: You can get high-quality SVG icons for your visual documentation straight from Microsoft (just be sure to read the terms). The link is here: https://learn.microsoft.com/en-us/azure/architecture/icons/#icon-terms

Once you download them, you can use a simple script to put them all in a single folder and clean up the file name. (I lost the one I wrote before, here's one from AI that worked for me today. It's overcomplicated but it works.). Just replace <FOLDERHERE> with where you extracted the downloaded folder.

# Set the root folder
$rootFolder = '<FOLDERHERE>'

# Get all .svg files in the root folder and its subfolders
$files = Get-ChildItem -Path $rootFolder -Filter *.svg -Recurse -File

# Loop through each file
foreach ($file in $files) {
    # Ensure the file is not already in the root folder
    if ($file.DirectoryName -ne $rootFolder) {
        # Extract the filename and remove the first 19 characters
        $newFileName = $file.Name.Substring(19)

        # Ensure the new filename is valid (avoid empty names)
        if ($newFileName -ne "") {
            # Set the destination path
            $destinationPath = Join-Path -Path $rootFolder -ChildPath $newFileName

            # Handle duplicate filenames by appending a number if necessary
            $counter = 1
            while (Test-Path $destinationPath) {
                $nameWithoutExt = [System.IO.Path]::GetFileNameWithoutExtension($newFileName)
                $extension = [System.IO.Path]::GetExtension($newFileName)
                $newFileName = "{0}_{1}{2}" -f $nameWithoutExt, $counter, $extension
                $destinationPath = Join-Path -Path $rootFolder -ChildPath $newFileName
                $counter++
            }

            # Move the file to the root folder with the new name
            Move-Item -Path $file.FullName -Destination $destinationPath
        } else {
            Write-Host "Skipping file $($file.FullName) because the new filename is empty after removing characters."
        }
    }
}

If you're on windows, SVGs won't load with thumbnails without something like powertoys (which you should have installed anyway, IMHO). https://github.com/microsoft/PowerToys

In conjunction with draw.io or the program of your chosing, this really levels up your documentation.

If you work with Azure diagrams, architecture docs, or decks, you might find this handy:

👉 https://az-icons.com

It’s a community project that keeps all the official Azure icons in one place — currently 693 icons, available in both SVG and PNG formats for easy use.

We just added the 10 new icons from Microsoft’s August 2025 drop, so the collection is fully up to date. The original set comes from Microsoft’s official release here: https://learn.microsoft.com/en-us/azure/architecture/icons/

Hopefully this saves some time for anyone tired of hunting down the right icons when building diagrams!