Pipeline Stages

Approvals Stage

Understanding the 6 approval types, submission process, and how to manage approval workflows.

The Approvals stage is the third step in the version pipeline. Before your app can be submitted for App Store review, it must receive sign-off from six reviewers across compliance and business categories.

How Approvals Work

Approvals are organized into two groups that must be completed in order:

Group 1: Compliance (Order 0)

These must be completed first before business approvals can proceed.

ApprovalReviewerMethod
OSPOAutomatedAutomated open-source license scan — no manual reviewer needed
LegalLegal teamManual form submission and review
ESROESRO teamManual form submission and review (Export/Sanctions compliance)

Group 2: Business (Order 1)

These become available after all compliance approvals are approved.

ApprovalReviewerMethod
Service OwnerYour app’s service ownerRouted automatically — reviewer receives email notification
Technical OwnerYour app’s technical leadRouted automatically — reviewer receives email notification
Product OwnerYour app’s product managerRouted automatically — reviewer receives email notification

Business approvals cannot be submitted until all three compliance approvals (OSPO, Legal, ESRO) are approved. This dependency is enforced by the system.

Each approval task syncs back to Bitrise Release Management automatically. You don’t need to update approvals in both systems.

Viewing Approvals

In the Approvals stage card on the Version Details page, you’ll see a table with columns:

ColumnDescription
RequirementThe approval type (e.g., OSPO, Legal, Service Owner)
Assigned toThe person responsible (or “Automated” for OSPO)
Submitted byWho submitted the form (dash for OSPO and not-yet-submitted approvals)
StatusCurrent status badge
Actions”View” link to the approval detail page

approvals-table

The Approvals stage showing all six approval tasks and their status

Approval Statuses

StatusMeaning
DraftNot yet submitted — form can be edited
Pending ReviewSubmitted and waiting for the reviewer’s decision
ScanningOSPO automated scan is in progress
Complete / ApprovedReviewer has approved
RejectedReviewer has rejected — changes needed
Changes RequestedReviewer wants specific changes before re-review

Legal and ESRO approvals require you to fill out a compliance form before sending it to the reviewer.

  1. Open the approval

    In the approvals table, click “View” next to the approval (e.g., Legal).

  2. Review the approval page

    You’ll see:

    • Application name, version number, and target release date in the header

    • The approval form with editable fields grouped by category

      approval-form

  3. Fill in the required fields

    Complete all required fields in the form.

  4. Save or submit

    You have two options:

    • “Save Draft” (top-right) — Save your progress without sending. You can return later to finish.
    • “Send Request” (top-right) — Submit the form and notify the reviewer via email.

Save drafts frequently if you’re gathering information over time. Your progress is preserved between sessions.

After submitting, the approval status changes to Pending Review and the assigned reviewer receives an email notification with a link to review and approve or reject.

How OSPO Approval Works

OSPO (Open Source Program Office) approval is fully automated — no manual form is needed.

  1. The system triggers an open-source license compliance scan using your selected build artifact
  2. The scan runs in the background
  3. Results show directly on the approval page:
    • Scanning status while the scan is running
    • Approved if the scan passes (no license violations)
    • Rejected if violations are found

See OSPO Compliance for full details on reading scan results, understanding violations, and downloading the SBOM.

How Business Owner Approvals Work

Service Owner, Technical Owner, and Product Owner approvals are automatically routed to the respective owners listed in your application record.

  1. Compliance approvals complete

    Once all compliance approvals are approved, business approvals become active.

  2. Owners receive email notifications

    Each owner receives an email notification with a link to review.

  3. Owner reviews and decides

    The owner clicks the link and can choose to:

    • Approve — Signs off on the release
    • Reject — Rejects the release with a reason
    • Request Changes — Asks for specific changes before re-review

    approval-business-owner

    The business owner approval page with approve/reject options

You don’t need to submit a form for business approvals — the system routes them automatically based on your application’s ownership configuration.

Hotfix Approval Fast Track

When a version is marked as a hotfix during creation:

  • Legal approval is automatically approved — no form submission or manual review needed
  • All other approvals proceed normally (ESRO, OSPO, business owners still require sign-off)

This speeds up critical fixes that need to reach production quickly.

Email Notifications

The system sends email notifications to approvers at key points:

  • When a form is submitted (Legal/ESRO) — Reviewer receives notification to review
  • When business approvals become active — Owners are notified they need to review

Each email contains a direct link to the approval page. Reviewers can click the link to view the submission and make their decision.

When All Approvals Are Complete

Once all six approvals show Approved status:

  • The Approvals stage is marked as Complete
  • The App Store Review stage becomes available
  • You can submit your app to Apple for review

Troubleshooting

Business approvals won’t activate:

  • Check that all three compliance approvals (OSPO, Legal, ESRO) are approved
  • Compliance approvals must be completed first due to the ordering dependency

An approval was rejected:

  • View the rejection reason on the approval detail page
  • Address the feedback, then coordinate with the reviewer for re-submission

Approver not receiving emails:

  • Verify the approver’s email address is correct in the application registry
  • Check spam/junk folders
  • Email delivery issues are logged but don’t block the approval workflow — the approval link can be shared manually

If an approval task is blocked or you’re unsure who to contact, reach out to your MCOE representative or check the MCOE support channel.

What’s Next