Skip to content

How to Setup Nintendo

Jump to bottom
James edited this page Aug 15, 2026 · 1 revision

Upload a build to the Nintendo Developer Center, and optionally notify your team afterwards.

!NOTE: The Nintendo service is marked Experimental. It works, but expect rough edges.

!IMPORTANT: This page only covers the Build Uploader side. Becoming an authorised Nintendo developer, getting the Nintendo SDK, and having a title registered are all handled by Nintendo under NDA and are outside what this tool does. If you don't already have SDK access, talk to your Nintendo account manager or start at the Nintendo Developer Portal.

Where things get saved

  • Edit->Preferences->Build Uploader->Services->Nintendo holds your SDK path and developer username. Saved to your own PC only - everyone on the team installs the SDK to their own location and signs in as themselves.
  • Project Settings->Build Uploader->Services->Nintendo holds title names, IDs and branches. Saved to <YourProjectPath>/BuildUploader/ and safe to commit so your team shares them.

1. Setup Preferences: Edit->Preferences->Build Uploader->Services->Nintendo

  • Turn on Enabled
  • Nintendo SDK Path: press ... and pick the folder you installed the Nintendo SDK into
    • The label turns green once the Build Uploader can read the SDK, red if it can't
    • Show opens the folder so you can check you picked the right one
    • ? opens the Nintendo Developer Portal
  • Developer Username: your Nintendo Developer Center username, used to authorise uploads
    • The label is red while this is empty

Team Notification (optional)

Only needed if you want to use the Nintendo Notify action. This posts to your own internal webhook - it is not a Nintendo service.

  • Webhook URL: the URL of your team's relay or webhook
  • Webhook Token: optional bearer token sent with the request

2. Setup Project Settings: Project Settings->Build Uploader->Services->Nintendo

  • Press New to create a Title
    • Name: anything you like. This is just a label so you can pick it in a dropdown later. eg: My Game
    • Title ID: the Nintendo-issued title identifier
    • Application ID: the Nintendo-issued application identifier
    • Default Branch: which branch new uploads go to unless told otherwise
  • Under Branches press + for each release ring you upload to. eg: internal, qa, submission

The Developer Portal button on this page opens the Nintendo Developer Center so you can look the IDs up.

3. Use it in an Upload Config

  • Go to Window->Build Uploader->Open Window
  • Add a Nintendo destination to your Upload Config
    • Title: the title you made
    • Branch: which release ring this build goes to
    • Description Format: the build description shown in the Nintendo Developer Center

Notifying your team

  • Add a Nintendo Notify action
    • Title: which title the notification is about
    • Branch: optional. Which branch it's about
    • Text: the message
    • Description Format: the build description sent alongside the notification
    • Message ID Format: optional. Names a {key} holding the ID returned by your webhook, so a later action can reference it
  • Set Triggers to OnTaskFinished and When To Execute to whichever suits you

!NOTE: This action posts to the webhook you set in Preferences. If no webhook is configured it has nowhere to send to.

Cleanup option

Back in Preferences there is a Delete authoring files after uploading toggle. Uploads generate authoring command files as they go; leave this on to have them removed when the upload completes, or turn it off if you want to inspect them afterwards.

Clone this wiki locally