Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Custom Mapbox Style Not Applying in Unity SDK, Works Correctly in Web (iframe)

Open
#1,964 22 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
45/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Quiet
Tech stack
csharp, unity
Domain
game-dev

Research direction

Start by reproducing the issue in the Unity SDK using Unity 6000.0.43f1, SDK v2.1.1, the public mapbox://styles/... URL, and the Editor on macOS Sonoma; compare the result with the working web iframe. Trace the Unity map Style field through style loading and rendering, and consider the issue done when the custom style renders instead of a black, default, or partially loaded map.

Written by the indexing model from the issue text.

Description

Description
When using a custom Mapbox style in the Unity SDK, the style does not apply correctly (or falls back to the default style). However, the same style works as expected when loaded via a Mapbox iframe on the web.

This suggests a possible issue with style compatibility, loading, or configuration specific to the Unity SDK.

Steps to Reproduce
Create a custom style in Mapbox Studio.
Publish the style.
Copy the style URL (e.g. mapbox://styles/username/style_id).

In Unity:
Use the Mapbox Unity SDK
Assign the custom style URL to the map’s Style field
Run the scene.

Expected Behavior
The map in Unity should render using the custom Mapbox style, matching the appearance seen on the web.

Actual Behavior
The custom style is not applied in Unity:
The map either renders black map
The style partially loads / fails silently
The same style URL renders correctly when used in a web iframe.

Environment
Unity Version: (6000.0.43f1)
Mapbox Unity SDK Version: (v2.1.1)
Platform: (Editor)
OS: (macOS Sonoma)

Style Details
Style created in Mapbox Studio
Style visibility set to Public
Style URL format: mapbox://styles/...
Works correctly in web iframe

Dominant language
C#
Stars
785
Forks
231
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from mapbox/mapbox-unity-sdk

All issues in mapbox/mapbox-unity-sdk

Similar issues

More C# issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.