Shopify Setup
Complete guide to connecting your Shopify store with STYLYS.
Overview
STYLYS integrates with Shopify through OAuth 2.0 authentication, enabling secure access to your product catalog without storing your credentials. Once connected, products sync automatically via webhooks.
Prerequisites
- An active Shopify store (Basic plan or higher)
- A STYLYS account with a verified email
- Admin access to your Shopify store
Connection Steps
1. Install from the Shopify App Store
Install STYLYS from the Shopify App Store — this automatically detects your store and starts the connection. If you need to reconnect later, go to Settings → Shopify Connection in your STYLYS dashboard.
2. Enter Your Store Name
If reconnecting via Settings, enter just your store name (e.g. "mystore") — STYLYS automatically appends .myshopify.com. If you installed from the Shopify App Store, this step is handled automatically and you can skip ahead.
3. Authorize Access
You'll be redirected to Shopify to approve the following permissions:
read_products— Access product detailsread_product_listings— Access how products are listed and organizedread_inventory— Check stock levelsread_themes— Detect whether the STYLYS widget is enabled in your themeunauthenticated_read_product_listings— Power the storefront-facing widget's product dataunauthenticated_read_product_tags— Power tag-based filtering in the widget
STYLYS never requests write access to your store.
4. Automatic Sync
Once authorized, your products will begin syncing automatically. Initial sync typically takes 1-5 minutes depending on catalog size.
Webhook Configuration
STYLYS automatically registers webhooks to keep your catalog in sync:
| Event | Description |
|---|---|
products/create | New products added to STYLYS |
products/update | Product changes synced automatically |
products/delete | Removed products archived in STYLYS |
inventory_levels/update | Stock status updated in real-time |
app/uninstalled | Cleanup when app is removed |
App Proxy
STYLYS uses Shopify App Proxy to serve the widget and quiz experience directly on your domain (e.g., yourstore.com/apps/stylys), giving you same-origin requests, better SEO, and seamless integration with your store's theme.
Troubleshooting
"Connection Failed" Error
Ensure you're using the correct store URL format (mystore.myshopify.com) and that you have admin access to the store.
Products Not Syncing
Check Sync Status in Settings — you'll see total/synced product counts and the last sync time. If products are out of date, click "Sync Products Now" to force a full catalog refresh.
Popup Blocked
If the authorization window doesn't open, allow popups for STYLYS in your browser settings and try again.