diff --git a/packages/thirdweb/src/react/core/utils/walletIcon.ts b/packages/thirdweb/src/react/core/utils/walletIcon.ts
index b7a93f4132e..815d0c4765a 100644
--- a/packages/thirdweb/src/react/core/utils/walletIcon.ts
+++ b/packages/thirdweb/src/react/core/utils/walletIcon.ts
@@ -50,8 +50,17 @@ export const socialIcons = {
   github: githubIconUri,
 };
 
-// TODO: this should return actual <svg> elements so they can be themed
-export function getSocialIcon(provider: AuthOption | ({} & string)) {
+/**
+ * Gets the icon URI for a given social authentication provider
+ * @param provider - The authentication provider to get the icon for
+ * @returns A data URI containing the SVG icon for the provider, or a generic wallet icon if the provider is not recognized
+ * @example
+ * ```tsx
+ * const googleIcon = getSocialIcon("google")
+ * const appleIcon = getSocialIcon("apple")
+ * ```
+ */
+export function getSocialIcon(provider: AuthOption | ({} & string)): string {
   switch (provider) {
     case "google":
       return googleIconUri;