diff --git a/docs/images/modals_get_radiobutton.png b/docs/images/modals_get_radiobutton.png
new file mode 100644
index 000000000..0e5e14005
Binary files /dev/null and b/docs/images/modals_get_radiobutton.png differ
diff --git a/services/modals/src/lib.rs b/services/modals/src/lib.rs
index 7dd7f0d6e..119463af2 100644
--- a/services/modals/src/lib.rs
+++ b/services/modals/src/lib.rs
@@ -607,6 +607,36 @@ impl Modals {
Ok(())
}
+ /// Creates modal dialog from list of items (list created by add_list or add_list_item) and returns String
+ /// value of selected item.
+ /// - Dialog cannot be dismissed without pressing 'ok'.
+ /// - 'ok' text is not editable.
+ /// - Any or none of the checked items are acceptable to be returned.
+ ///
+ ///
+ /// Example Image
+ ///
+ /// 
+ ///
+ ///
+ ///
+ /// # Example
+ /// ```
+ /// use modals::Modals;
+ /// use xous_names::XousNames;
+ /// let xns = XousNames::new().unwrap();
+ /// let modals = Modals::new(&xns).unwrap();
+ ///
+ /// const RADIO_TEST: [&'static str; 4] = ["zebra", "cow", "horse", "cat"];
+ ///
+ /// for item in RADIO_TEST {
+ /// modals.add_list_item(item).expect("couldn't build radio item list");
+ /// }
+ /// match modals.get_radiobutton("Pick an animal") {
+ /// Ok(animal) => log::info!("{} was picked", animal),
+ /// _ => log::error!("get_radiobutton failed"),
+ /// }
+ /// ```
pub fn get_radiobutton(&self, prompt: &str) -> Result {
self.lock();
let spec =