Skip to main content

WebGoogleSigninButton

This is the sign-in button that you can use in web apps. It renders null when used in native apps. It has a slightly different API than the native GoogleSigninButton component which is why it exists as a separate component.

tip

The functionality covered in this page is available in the licensed version. You can get a license here ⭐️.

The button will not render before the Google Client API has been loaded. You can use the onError prop to detect this case.

How to use this

As the Universal sign in Guide explains, there are two ways to sign in on the web: using the One-tap UI or using the Google Sign-In button.

One-tap UI may not always be available: This happens if user has opted out or when they close the dialog several times in a row, entering the cooldown period.

The Google Sign-In button serves as a fallback. Tapping it will open the regular Google Sign-In dialog.

import { WebGoogleSigninButton } from '@react-native-google-signin/google-signin';

<WebGoogleSigninButton />;

Props

All props are optional.

NameTypeDescription
type?"standard" | "icon"The type of the sign-in button.
theme?"outline" | "filled_blue" | "filled_black"The theme of the sign-in button.
size?"large" | "medium" | "small"The size of the sign-in button.
text?"signin_with" | "signup_with" | "continue_with" | "signin"The text to display on the sign-in button.
shape?"rectangular" | "pill" | "circle" | "square"The shape of the sign-in button.
width?numberThe width of the sign-in button.
locale?stringThe locale for the sign-in button.
logoAlignment?"left" | "center"The alignment of the logo on the button.
onError?(error: Error) => voidCalled when you try to render the button before the Client SDK is loaded.