diff --git a/platform/ios/platform/ios/src/MLNMapViewDelegate.h b/platform/ios/platform/ios/src/MLNMapViewDelegate.h
index da660fcfff5..bf1a05b711f 100644
--- a/platform/ios/platform/ios/src/MLNMapViewDelegate.h
+++ b/platform/ios/platform/ios/src/MLNMapViewDelegate.h
@@ -276,6 +276,12 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (void)mapView:(MLNMapView *)mapView didFinishLoadingStyle:(MLNStyle *)style;
 
+/**
+ Tells the delegate that the `mapView` is missing an image. The image should be added synchronously with `-[MLNStyle setImage:forName:]` to be rendered on the current zoom level. When loading icons asynchronously, you can load a placeholder image and replace it when your image has loaded.
+
+ @param mapView The map view that is loading the image.
+ @param imageName The name of the image that is missing.
+ */
 - (nullable UIImage *)mapView:(MLNMapView *)mapView didFailToLoadImage:(NSString *)imageName;
 
 /**
diff --git a/platform/ios/platform/macos/src/MLNMapViewDelegate.h b/platform/ios/platform/macos/src/MLNMapViewDelegate.h
index 4cfaf8b7fa7..486abc7aca7 100644
--- a/platform/ios/platform/macos/src/MLNMapViewDelegate.h
+++ b/platform/ios/platform/macos/src/MLNMapViewDelegate.h
@@ -181,6 +181,12 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (void)mapView:(MLNMapView *)mapView didFinishLoadingStyle:(MLNStyle *)style;
 
+/**
+ Tells the delegate that the `mapView` is missing an image. The image should be added synchronously with `-[MLNStyle setImage:forName:]` to be rendered on the current zoom level. When loading icons asynchronously, you can load a placeholder image and replace it when your image has loaded.
+
+ @param mapView The map view that is loading the image.
+ @param imageName The name of the image that is missing.
+ */
 - (nullable NSImage *)mapView:(MLNMapView *)mapView didFailToLoadImage:(NSString *)imageName;
 
 /**