Shopify Custom App Dev Dashboard: Setup & Deploy Guide

The Shopify custom app dev dashboard is the central place to create, configure, and deploy custom apps for a single store or multiple stores. If you're migrating from the old Partner Dashboard workflow or starting fresh, this guide walks you through every step: from creating your app to testing locally and releasing versions. We'll also help you decide when a custom app makes sense versus installing an existing one. For merchants and developers who need expert help, our Shopify app development services can accelerate your project.

What the Dev Dashboard replaced and why it matters

Shopify's Dev Dashboard consolidates app management that used to be scattered across the Partner Dashboard and store admin. It provides a unified interface for custom apps, public apps, and custom distribution. The key change is that custom apps are now first-class citizens: you can manage API credentials, access scopes, and versions directly from the Dev Dashboard without needing a Partner account for single-store apps.

This matters because it simplifies the development lifecycle. You no longer need to juggle multiple dashboards to configure a custom app for your store. Everything—from creation to deployment—happens in one place.

Key differences from the old workflow

• Single-store custom apps can be created directly from your store admin under Apps > Develop apps, which links to the Dev Dashboard.
• API credentials (API key and secret) are generated and managed in the Dev Dashboard.
• Access scopes are configured per app and can be updated without recreating the app.
• Version management allows you to deploy updates and roll back if needed.

Creating a custom app and choosing distribution

Before you start, decide on the distribution model:

• Single-store custom app: Only for your own store. Created from your store admin. No Partner account required.
• Custom distribution app: For multiple stores you own or manage (e.g., a franchise). Requires a Partner account and is managed via the Dev Dashboard.
• Public app: For the Shopify App Store. Requires a Partner account and goes through Shopify's review process.

For most merchants building an internal tool, a single-store custom app is sufficient. Here's how to create one:

1. From your Shopify admin, go to Apps > Develop apps.
2. Click Create an app.
3. Enter a name and click Create app.
4. You'll be redirected to the Dev Dashboard to configure the app.

For custom distribution, log in to your Partner Dashboard, navigate to Apps > Dev Dashboard, and click Create app. Choose Custom distribution and follow the prompts.

Configuring access scopes and API credentials

Access scopes define what your app can do with store data. Follow the principle of least privilege: request only what you need.

In the Dev Dashboard, go to your app's Configuration tab. Under Admin API access scopes, select the scopes your app requires. For example, to read products and orders, you'd select read_products and read_orders. You can update scopes later, but changes require reauthorization.

After saving scopes, go to the API credentials section. Here you'll find your API key and secret. For custom apps, you'll also generate an access token by installing the app on your store. Keep these credentials secure—never expose them in client-side code.

Tip: Use environment variables to store credentials in your local development environment.

Local development, tunneling and testing

To develop locally, you need to expose your local server to the internet so Shopify can send requests. Use a tunneling tool like ngrok or Cloudflare Tunnel.

1. Start your local development server (e.g., Node.js with Express).
2. Run a tunnel: ngrok http 3000 (replace 3000 with your port).
3. Copy the HTTPS URL provided by ngrok.
4. In the Dev Dashboard, go to your app's Configuration tab and set the App URL to your tunnel URL.
5. Set the Redirect URL for OAuth (e.g., https://your-tunnel.ngrok.io/auth/callback).
6. Install the app on your development store to generate an access token.

Now you can test API calls using the access token. Use the Shopify API libraries (e.g., @shopify/shopify-api for Node) to handle authentication and requests.

Testing checklist

• OAuth flow completes and redirects correctly.
• API calls return expected data.
• Webhooks are received and processed (if used).
• Error handling works for invalid scopes or expired tokens.
• App uninstall and reinstall works cleanly.

Deploying and managing versions

When your app is ready for production, you'll deploy it to a hosting provider (e.g., Vercel, Heroku, AWS). Then update the app URLs in the Dev Dashboard to point to your production domain.

For version management:

• In the Dev Dashboard, go to your app's Versions tab.
• Click Create version to snapshot your current configuration (scopes, URLs, etc.).
• After testing, click Release to make it live.

This allows you to roll back to a previous version if something goes wrong. Note that access scope changes require the merchant to reauthorize the app.

Deployment steps

1. Deploy your code to a production server with HTTPS.
2. Update App URL and Redirect URL in the Dev Dashboard to your production domain.
3. Create a new version and release it.
4. Install the app on your production store (if not already installed).
5. Monitor logs for errors.

When to build custom vs. use an existing app

Custom apps are powerful but require ongoing maintenance. Use this checklist to decide:

Factor	Custom App	Existing App
Unique workflow	✅ Tailored exactly	❌ Limited by app features
Data sensitivity	✅ Full control	❌ Third-party access
Budget	❌ Higher upfront cost	✅ Lower upfront cost
Maintenance	❌ You handle updates	✅ Vendor handles updates
Time to market	❌ Longer development	✅ Quick install
Integration needs	✅ Deep integration	❌ May require workarounds

Build custom when:

• Your process is unique and no existing app fits.
• You need tight integration with internal systems (ERP, CRM).
• You want full control over data and security.
• You have developer resources or a partner.

Use an existing app when:

• A well-reviewed app meets 80%+ of your needs.
• You lack development resources.
• You need a quick solution.

If you're unsure, our team can help you evaluate. Contact us for a consultation.

Common pitfalls to avoid

• Requesting excessive scopes (security risk and merchant distrust).
• Hardcoding credentials in code.
• Skipping version control for app configuration.
• Not handling API rate limits.
• Forgetting to update redirect URLs after deployment.

By following this walkthrough, you can confidently use the Shopify custom app dev dashboard to build and deploy custom apps that power your store's unique workflows.

Related reading

• Does Shopify Allow Custom App Development? Rules & Dev Dashboard
• Custom Shopify App Development Services: What You Get