---
updatedAt: 2026-05-11T19:52:24.000Z
agentTools:
  siteIndex: https://docs.gusto.com/llms.txt
  projectIndex: https://docs.gusto.com/embedded-payroll/llms.txt
---

# Customize flows

Gusto Flows offer customization options that allow you to tailor the appearance of flows to align with your branding. Use the [Gusto Developer Portal](https://dev.gusto.com/) to configure flows for Demo or Production, and to update UI styles.

If the level of customization with flows doesn’t meet your needs, you might consider using [React SDK components](https://docs.gusto.com/embedded-payroll/docs/react-sdk)—which you can also use alongside flows.

## Prerequisites

Before you can customize your flows, make sure that your account on the [Gusto Developer Portal](https://dev.gusto.com/) is configured as an Embedded Developer account and that you have an Organization.

## Updating flow appearance in the Developer Portal

To update embedded flow styling:

1. Sign in to the [Gusto Developer Portal](https://dev.gusto.com/).
2. Navigate to **Organizations** in the left sidebar and select the desired organization.
3. Click the **Flow Settings** tab.
4. Adjust style settings.
5. Click **Submit & Save** to apply your changes.

### Available customization options

* **Color and styling adjustments**: Modify flow elements such as buttons, headers, background colors, and text styles
* **Font customization**: Upload and apply custom fonts (`.ttf`, `.woff`, `.woff2` formats are supported).
* **Visibility controls**: Enable or disable certain UI components based on user preferences.

## Managing settings for Demo and Production environments

Configure styling separately for **Demo** and **Production** to safely test changes on Demo before making them live for your users.

<Table>
  <thead>
    <tr>
      <th>
        Environment
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Demo
      </td>

      <td>
        Use for testing and previewing changes  
        Does not affect real employee or payroll data  
        Supports unrestricted modifications so you can freely experiment
      </td>
    </tr>

    <tr>
      <td>
        Production
      </td>

      <td>
        Used for live payroll and HR operations  
        Requires an active Production API key  
        Ensure you’ve validated changes in Demo before applying
      </td>
    </tr>
  </tbody>
</Table>

To select the environment, sign in to the [Developer Portal](https://dev.gusto.com/) and go to **Organizations** > **\[Your organization]** > **Flow Settings**, as shown here:

<Image align="center" alt="View of Gusto's Developer Portal within an organization's flow settings, where there are radio button options for selecting either the Demo or Production environment" src="https://files.readme.io/c77bea6-Screenshot_2024-04-16_at_10.53.38_AM.png" />

<br />

## FAQ

### How can I preview style changes before going live?

Always preview your flow styling, including any font settings, before applying them to Production to ensure they align with your branding and usability goals, and to reduce the risk of UI inconsistencies.

1. Sign in to the [Developer Portal](https://dev.gusto.com/) and go to **Organizations** > **\[Your organization]** > **Flow Settings**.
2. Make style edits.
3. Click **View Style Guide** to generate a preview.
4. Review your modifications, including any updates to fonts, buttons, colors, and layout.
5. If satisfied, click **Submit & Save**.

### How do I customize fonts?

1. Sign in to the [Developer Portal](https://dev.gusto.com/) and go to **Organizations** > **\[Your organization]** > **Flow Settings**.
2. Scroll to the **Font** section.

   <br />

   <Image align="center" src="https://files.readme.io/2d7ff30-image3.png" />

   <br />
3. Select an option from the dropdown:
   * Select **Custom font** from the dropdown to upload your font file in `.ttf`, `.woff`, or `.woff2` format.
   * Select **Default web font** and specify the font type to use web fonts commonly supported by browsers by default.
4. Click **Save** to confirm.

> 📘 Important considerations
>
> Saving a custom font will apply the font across **all** of the flows in your organization, as fonts cannot be applied on a per-flow basis.
>
> If you remove a custom font, flows will automatically revert to the default web font.

## Next steps

If you haven't already, check out the [Quickstart](https://docs.gusto.com/embedded-payroll/docs/flows-quickstart) for Gusto Flows. Otherwise, read about [flow types](https://docs.gusto.com/embedded-payroll/docs/flow-types) and [flow events](https://docs.gusto.com/embedded-payroll/docs/flow-events) to learn about the types of flows available and how to interact with them.