diff --git a/README.md b/README.md
index a558bdf..c4c43b7 100644
--- a/README.md
+++ b/README.md
@@ -11,10 +11,11 @@ icon-color-tool path/to/icon.svg # opens directly in the color editor
 ```
 
 The picker's search box does a fuzzy (subsequence) match against each
-icon's path. Selecting an icon (or passing one directly) opens the color
-editor: click a swatch to pick a new color for that `ColorScheme-*` class;
-changes save to disk immediately, and Undo/Redo are available from the
-toolbar.
+icon's path, automatically prioritizing the highest-resolution version of each icon. 
+Selecting an icon (or passing one directly) opens the color editor:
+- **Color Editing**: Click a swatch to pick a new color for that `ColorScheme-*` class.
+- **Emblem Support**: Click "Add Emblem" to overlay another SVG on top of your background icon. You can drag to position it visually, or use sliders to adjust its X, Y, and Size. The tool automatically namespaces the emblem's CSS so you can color its layers independently from the background.
+- **Saving**: Source files are preserved. Modifications are kept in memory until you use the "Save As..." button to export a new SVG. Unsaved changes are protected by a confirmation prompt if you try to exit. Undo/Redo are available from the toolbar.
 
 ## Configuration