HULL template: Shopify products not syncing and Vercel deployment issues

I can help you troubleshoot your HULL template setup! Based on the official HULL documentation, here are the likely causes and solutions for both of your issues.

Issue 1: Shopify Products Not Syncing

The most common reason products aren't appearing is that webhooks aren't properly configured or existing products haven't been triggered to sync yet.

Critical: Webhook Configuration

Your webhooks must point to your live Vercel domain (not localhost). Go to Shopify Admin → Settings → Notifications → Webhooks (scroll to bottom) and verify you have these three webhooks:

• Product creation → https://[your-vercel-domain]/api/shopify/product-update
• Product update → https://[your-vercel-domain]/api/shopify/product-update
• Product deletion → https://[your-vercel-domain]/api/shopify/product-delete

Important: Existing Products Won't Auto-Sync

This is key - existing products in Shopify won't automatically sync when you first set everything up. Webhooks only fire when changes occur. To trigger a sync for your existing products:

1. Go to each product in Shopify
2. Make a small change (even just adding a space to the description)
3. Save the product
4. This triggers the webhook and syncs that product to Sanity

Verify Your Shopify App Configuration

According to the HULL setup instructions, make sure you properly configured both API scopes when you created your custom Shopify app:

Admin API scopes (Configuration → Admin API integration):

• write_products
• read_products

Storefront API scopes (Configuration → Storefront API integration):

• unauthenticated_read_product_listings
• unauthenticated_read_product_inventory
• unauthenticated_write_checkouts
• unauthenticated_read_checkouts

Check Your Environment Variables

Verify these are correctly set in both your local .env.local AND in Vercel:

• NEXT_PUBLIC_SHOPIFY_STORE_ID - Your store subdomain (without .myshopify.com)
• NEXT_PUBLIC_SHOPIFY_STOREFRONT_API_TOKEN - From your custom app's Storefront API credentials
• SHOPIFY_ADMIN_API_TOKEN - From your custom app's Admin API credentials (you can only see this once!)
• SHOPIFY_WEBHOOK_INTEGRITY - The integrity hash from Shopify's webhook settings
• SANITY_API_TOKEN - Must have read+write permissions

Issue 2: Vercel Deployment Not Showing Changes

This is likely a deployment trigger or environment variable issue.

Install the Vercel Deploy Plugin

The HULL template works with the sanity-plugin-vercel-deploy plugin (created by the HULL author specifically for this purpose). This allows you to trigger Vercel builds directly from the Sanity Studio, which is what the "Deployment" tab in Studio expects.

Verify Vercel Environment Variables

All your environment variables from .env.local must be added to your Vercel project:

• Go to Vercel project → Settings → Environment Variables
• Add all the variables (they should match your local setup exactly)
• Redeploy after adding/updating variables - this is critical!

Check Your Vercel Deployment Logs

• Go to your Vercel project → Deployments tab
• Click on the latest deployment and review the logs for any errors
• Make sure the build is completing successfully

Quick Troubleshooting Steps

1. Test webhook connectivity: In Shopify's webhook settings, you can manually trigger a test webhook to see if it's reaching your Vercel deployment
2. Check Sanity Studio: Log into your Studio and look under "Products" to see if anything has synced
3. Review Vercel function logs: Check your Vercel function logs to see if the webhook endpoints are receiving requests from Shopify
4. Hard refresh your browser: Try Cmd/Ctrl + Shift + R to clear any cached content

Since you followed everything "to a T," the most likely issue is that your webhooks are either pointing to the wrong domain or your existing products simply haven't been triggered to sync yet. Try editing one product in Shopify as a test - make a small change, save it, then check your Sanity Studio to see if it appears.

Good luck with your launch! The HULL template uses webhooks to sync products in real-time, so once you get them properly configured and trigger a sync by editing products, everything should flow through smoothly.