# Integrate with Hiro

**URL:** https://heroiclabs.com/docs/satori/concepts/remote-configuration/integrate-with-hiro/
**Summary:** Connect Hiro's metagame framework to Satori so that every Hiro system becomes remotely configurable through the Satori console, with no additional client code required.
**Keywords:** hiro satori integration, SatoriPersonalizer, hiro feature flags, hiro remote configuration, metagame remote config, hiro economy satori, personalizer
**Categories:** satori, remote-configuration

---


# Integrate with Hiro

[Hiro](../../../../hiro/concepts/introduction/) is a client-server framework built on Nakama, the open-source game backend, designed to help you implement core metagame systems quickly and reliably.

Studios using Hiro's metagame framework can connect it to Satori so that every Hiro system, including economy, achievements, event leaderboards, progression, and more, becomes remotely configurable through the Satori console. Your LiveOps team can adjust metagame parameters, target different configurations to different audiences, and run experiments on Hiro systems without any additional client code.

{{< screenshot src="images/hiro-feature-flags.png" alt="All Hiro systems can be remotely configured in the Satori console via feature flags" caption="All Hiro systems can be remotely configured in Satori via feature flags" width="100%" >}}

The connection between the two products is handled by a component called the **SatoriPersonalizer**.

## How the SatoriPersonalizer works

Hiro uses a system called Personalizers to serve custom content to individual players. The SatoriPersonalizer is a built-in implementation that connects this system to Satori's feature flags.

When active, the SatoriPersonalizer checks whether Satori has any flag overrides for the current player and merges them into Hiro's static configuration before the result is returned. If a flag variant targets a specific audience, that audience's players receive the merged configuration while everyone else receives the static defaults. No additional client code is required.

For a full explanation of how Personalizers work, including merge behavior and personalizer chaining, see [Personalizers](/hiro/concepts/personalizers/).

## What you can configure

Each Hiro system appears as a feature flag in Satori with a corresponding Hiro-specific schema. Edit the default value to change the baseline configuration, or create audience-targeted variants to deliver different configurations to different player segments. Live events and experiments can override these flags just like any other feature flag.

For example, create a variant of the `Hiro-Economy` flag that offers a discounted store bundle to lapsed spenders, or run an experiment on `Hiro-Achievements` that tests whether higher reward values improve retention for new players.

Satori provides pre-built schema templates for every Hiro system. When creating or editing a Hiro flag, you can do so via the form-based wizard or by editing the JSON directly by toggling on **Traditional View** in the UI.

{{< screenshot src="images/hiro-edit-wizard.png" alt="The form-based wizard in the Satori console allows Hiro systems to be created and edited via guided questions and prompts." caption="The form-based wizard makes for easier viewing and editing of different Hiro systems" width="100%" >}}

{{< note "important" >}}
Hiro flags can only have their value and description updated. The name, schema, and other fields are locked. Hiro flags can't be deleted.
{{< /note >}}

## Set up the SatoriPersonalizer

In your server initialization code, add the SatoriPersonalizer after initializing your Hiro systems:

```go
// After initializing Hiro systems...
systems.AddPersonalizer(hiro.NewSatoriPersonalizer(ctx, logger, nk, initializer))
```

For full setup instructions, including how to chain multiple personalizers and configure Satori connection details in Heroic Cloud, see [Set up built-in personalizers](/hiro/concepts/personalizers/).