HULL template: Shopify products not syncing and Vercel deployment issue...

10 replies

Last updated: Dec 1, 2025

Hello there,
I setup an ecommerce site on my local machine with the HULL template a few months ago. Now that we're finally ready to launch the site, I've revisited the project that I've customized with my Shopify and Klaviyo accounts setup. I have products and the necessary API keys and tokens. I have entered all of the fields in the ".env .local" file and able to log into the studio. Everything seems to be working besides two things.

1. I'm not seeing any of my products from Shopify(even after making a slight change to the description - to see if it will populate)
2. I'm not able to see the changes on my Vercel deployment(i've added all requested info in the "deployment" tab in the studio as well.

I believe I've followed all instructions to a T, but apparently I've done something wrong. Does anyone have experience with setting up HULL that's willing to help?

Thank you!

AI Update

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:

Go to each product in Shopify
Make a small change (even just adding a space to the description)
Save the product
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

Test webhook connectivity: In Shopify's webhook settings, you can manually trigger a test webhook to see if it's reaching your Vercel deployment
Check Sanity Studio: Log into your Studio and look under "Products" to see if anything has synced
Review Vercel function logs: Check your Vercel function logs to see if the webhook endpoints are receiving requests from Shopify
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.

Show original thread