Skip to main content

Gatey Overview

Gatey brings Amazon Cognito login and SSO to WordPress with a clean, front‑end–only approach. Drop an Authenticator block on any page, use shortcodes where you need them, and control visibility with dynamic CSS variables. Because authentication happens in the browser, Gatey also works when your site is exported to static HTML and served from S3/CloudFront or any CDN.

Static‑site friendly

No PHP callbacks. No secrets stored in WordPress. Your sign‑in flow runs entirely in the browser against your own Cognito User Pool.

What this documentation covers

This section focuses on reference material (no tutorials):

  • Shortcodes — full options for [gatey] and [gatey-account]
  • CSS Variables — dynamic custom properties for visibility and content
  • JavaScript API — helpers, DOM events, and Redux observers

For step‑by‑step setup or migration scenarios, see the blog series on wpsuite.io (outside of this docs section).

Key capabilities

  • Front‑end–only Cognito flow (no server‑side OAuth handling)
  • Block‑based UI with optional modal behaviour
  • 22+ languages with LTR/RTL control
  • Conditional layouts via CSS custom properties
  • Signed API calls (JWT/IAM) straight from the browser
  • Insert an Authenticator anywhere with the [gatey] shortcode
  • Print a user attribute with [gatey-account attribute="given_name"]
  • Listen to <Authenticator> events like signed-in.gatey-authenticator
  • Call your API with WpSuite.plugins.gatey.cognito.post({ apiName, path, options })