> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.simplyprint.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Set up Google Workspace Single sign-on (SSO) for SimplyPrint

| This guide is for SimplyPrint customers with the Print Farm, School or Enterprise plan who use Google Workspace as their Identity Provider for Single Sign-On.
| If you don't use Google Workspace, but rather another SSO provider, check out our other SSO guide(s) here: [Set up Single sign-on (SSO) for SimplyPrint](https://help.simplyprint.io/en/article/set-up-single-sign-on-sso-for-simplyprint-4coj1g/)

This guide explains how to connect **Google Workspace (Admin Console)** with **SimplyPrint** using SAML 2.0. After setup, staff and students can sign in to SimplyPrint using their Google Workspace accounts.

You can follow the interactive guide below, or the written instructions further down to see exactly how to set up SimplyPrint SSO with Google Workspace.

${frame}[Setup guide](https://demo.arcade.software/ccIUBpdXjLn4wo9vsSjH?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=false)

| Tip: if you or anyone from your team already has a SimplyPrint account, created without SSO, you can link your account after setting up SSO! More here: [Linking your existing SimplyPrint account to your SSO account](https://help.simplyprint.io/en/article/linking-your-existing-simplyprint-account-to-your-sso-account-5pw0aj/)

## Part 1: Prepare SimplyPrint
1. Go to your SimplyPrint dashboard → [Organization Settings → Registration & SSO](https://simplyprint.io/panel/settings/organization#registration).
2. Enable **SAML Single Sign-On (SSO)**.
3. Click **Edit SAML Configuration**.

Keep this page open — we’ll come back to fill in details later.

## Part 2: Configure a custom SAML app in Google Workspace

| Visit Google's own guide on how to add a Custom SAML App for the most up-to-date information: https://support.google.com/a/answer/6087519

1. Open the [Google Admin Console](https://admin.google.com/).
2. Go to **Apps → Web and mobile apps**.
3. Click **Add App → Add custom SAML app**.
4. Enter a name (e.g. **SimplyPrint**) and optionally:
    * Description: “SSO integration with SimplyPrint” *(optional)*
    * Logo: Download one from [SimplyPrint branding](https://simplyprint.io/branding) and upload *(optional)*
5. Click **Continue**.

## Part 3: Get Google IdP details for SimplyPrint
1. Google will now show you the **Identity Provider (IdP) details**.
2. Download the **IdP metadata file** (XML).
3. Switch back to SimplyPrint’s **Edit SAML Configuration** window and fill in:
    * **Entity ID (Issuer)** → copy from Google.
    * **SSO URL (Login URL)** → copy from Google.
    * **X.509 Certificate** → copy from Google (or upload from metadata file).
    * Leave **SSO Binding** as **HTTP-Redirect** (default).
4. Click **Save** in SimplyPrint (you can always come back if you need to adjust mappings).

## Part 4: Provide SimplyPrint details to Google Workspace
Now we need to tell Google where to send logins.
1. Back in Google Admin Console, Google asks for **Service Provider (SP) details**.
2. Copy the following values from SimplyPrint’s metadata:
    * **ACS URL** (Assertion Consumer Service URL)
    * **Entity ID** (SP identifier)
3. Paste these into Google’s form.
4. Leave other fields (Start URL, Signed response, etc.) at their defaults.
5. Click **Continue**.

## Part 5: Map user attributes
We now decide which user information from Google Workspace should be sent to SimplyPrint.
1. In Google Admin Console → **Attribute Mapping**, click **Add Mapping**.
2. Add the following mappings:
| Google attribute | SimplyPrint field | Notes |
| ---- |
| `First name` (givenName) | `first_name` | Required with "last name", unless "Full name" is used |
| `Last name` (familyName) | `last_name` | Required with "last name", unless "Full name" is used |
| `Primary email` | `email` | Optional |
| `Full name` (displayName) | `full_name` | Required unless "First name" and "Last name" is set |
3. (Optional) Add extra mappings:
    * **Groups** → `user_group`
    * **Custom attribute `isTeacher`** → `school_is_teacher` (expects true/false or yes/no)
    * **Custom attribute `classes`** → `school_classes` (comma- or semicolon-separated if multiple)
👉 The attribute names you type in Google (`first_name`, `last_name`, etc.) must match what you enter under **Attribute Mappings** in SimplyPrint.

## Part 6: Enable the app for users
1. In Google Admin Console, review the configuration and click **Finish**.
2. Open the new SimplyPrint app → **User Access** → set to **ON for everyone** (or specific groups).

## Part 7: Test the connection
1. In Google Admin Console, click **Test SAML login**.
2. Sign in with a Google Workspace account.
3. If successful, you’ll be redirected into SimplyPrint.
4. If not, double-check:
    * ACS URL and Entity ID match between SimplyPrint and Google.
    * Certificate is correct and complete.
    * Attribute names match exactly (case-sensitive).

## Part 8: (Optional) Show your school on the SimplyPrint login page
To make login easier for students:
1. In [Organization Settings → Registration & SSO](https://simplyprint.io/panel/settings/organization#registration), enable:
**“Show school/organization in the public list shown on login page.”**
2. Your school will now appear in the dropdown at:
    * [https://simplyprint.io/panel/login](https://simplyprint.io/panel/login)
    * [https://simplyprint.io/panel/login/school](https://simplyprint.io/panel/login/school)

**See how to log in using SSO here**: [Signing in with SSO / Organization Login](https://help.simplyprint.io/en/article/signing-in-with-sso-organization-login-1v0eb2h/)

# Link existing accounts (email & password signups) to an SSO account
If you, members of your team or students have already signed up for your SimplyPrint organization without SSO, by simply registering on our site with their name, email and password, they can

**Learn how to here:** [Linking your existing SimplyPrint account to your SSO account](https://help.simplyprint.io/en/article/linking-your-existing-simplyprint-account-to-your-sso-account-5pw0aj/)

# Issues? Troubleshoot your SSO integration here!
Visit our "SSO troubleshooting" guide for troubleshooting help: [SSO troubleshooting: how to fix errors like "first_name not set"](https://help.simplyprint.io/en/article/sso-troubleshooting-how-to-fix-errors-like-firstname-not-set-pgdbiz/)