Bitrise Immerse

Manage Rollout

Rollout Setup Checklist

Understanding the compliance checklist and completing each configuration item.

After creating a rollout, you’ll see the Rollout Checklist page. This is your rollout’s main dashboard — it shows what needs to be configured before your rollout is ready for releasing versions.

Accessing the Checklist

Navigate to your rollout from the Rollout Select page. The checklist is the default landing page for any rollout, located at:

/beta/rollouts/{askId}/{rolloutName}

rollout-checklist

The Rollout Checklist page showing configuration status for each item

Checklist Items

The checklist is divided into items, each representing a configuration requirement. Items show as complete (green check) or incomplete (empty circle) based on whether the requirement is satisfied.

1. Repository

What it checks: A source code repository is connected to your rollout.

  1. Click the repository checklist item

    A dialog opens where you can search for your GitHub repository.

  2. Search for and select your repository

    Type your repository name to filter results, then select it.

    The repository connection dialog

  3. Confirm the connection

    Click Confirm to link the repository to your rollout.

The connected repository is used for security scanning (code scanning, Dependabot alerts, secret scanning) and provides the source code for your Bitrise builds.

2. Global Settings

What it checks: Required metadata fields are filled in for your rollout’s global configuration.

The following fields must be set:

FieldDescription
Support URLLink to your app’s support page
Marketing URLLink to your app’s marketing page
Privacy Policy URLLink to your app’s privacy policy
CopyrightCopyright notice for your app

  1. Open Global Settings

    Click “Settings” on the checklist page, or navigate to the Global Settings page directly.

  2. Go to the Global tab

    Select the Global tab if it’s not already selected.

  3. Fill in the required fields

    Enter the Support URL, Marketing URL, Privacy Policy URL, and Copyright fields.

  4. Save

    Click Save in the top-right corner.

See Settings for detailed instructions on all configuration options.

3. Bitrise Integration

What it checks: Your rollout is connected to Bitrise for CI/CD and Release Management.

Two values must be configured:

FieldDescriptionWhere to Find It
Bitrise App SlugIdentifies your app in Bitrise CIVisible in the URL at app.bitrise.io/app/{app-slug}
Bitrise Project IDIdentifies your project in Bitrise Release ManagementFound in Bitrise Release Management settings

  1. Navigate to rollout settings

    Go to the rollout settings page.

  2. Enter Bitrise App Slug and Project ID

    Fill in both fields with the values from your Bitrise project.

  3. Save the configuration

    Click Save to confirm.

4. Approver Mappings

What it checks: All six approval roles have assigned reviewers.

RoleSource
LegalAssigned from system configuration
ESROAssigned from system configuration
OSPOAssigned from system configuration (automated)
Service OwnerPulled from your application record
Technical OwnerPulled from your application record
Product OwnerPulled from your application record
  • System approvers (Legal, ESRO, OSPO) are pre-configured — no action needed
  • Business approvers (Service Owner, Technical Owner, Product Owner) are automatically pulled from your application record in the Immerse application registry
If a business approver is missing, update the owner fields in your application record in the Immerse Applications module. The rollout will pick up the changes.

Checklist Status

StatusMeaning
All items completeYour rollout is configured and ready — you can create versions
Some items incompleteReview the incomplete items and follow the steps above to resolve them
You can create versions even if some checklist items are incomplete, but approval workflows require approver mappings to be in place, and OSPO compliance checks require Bitrise integration to be configured.

From the checklist page, you can:

  • Click “Settings” to manage rollout name and repository configuration
  • Click individual checklist items to view details or take action
  • Navigate to Versions to see or create versions for this rollout

What’s Next