# PromoSync Documentation > PromoSync is a Shopify app that syncs promotional products, inventory, and pricing from PromoStandards suppliers to your Shopify store. - [Home](https://promosync-docs.psrestful.com): Learn how PromoSync syncs promotional products, inventory, and pricing from PromoStandards suppliers to your Shopify store. Guides, settings, and API reference. ## Getting Started - [Installation](https://promosync-docs.psrestful.com/installation): Install PromoSync from the Shopify App Store, walk through the three-step onboarding wizard, and import your first sample products. - [Features](https://promosync-docs.psrestful.com/features): Explore PromoSync's product import, automated inventory sync, advanced pricing, Google Merchant integration, bulk actions, and 70+ metafields for Shopify. - [What is PromoStandards?](https://promosync-docs.psrestful.com/what-is-promostandards): Learn what PromoStandards is, how the promotional products industry uses it, and how PromoSync brings it into your Shopify store via the PSRESTful API. - [Why PromoSync?](https://promosync-docs.psrestful.com/why-promosync): Discover why promotional products distributors choose PromoSync to automate product imports, inventory sync, and pricing from 100+ PromoStandards suppliers to Shopify. ## Settings - [Settings Overview](https://promosync-docs.psrestful.com/settings): Configure pricing, inventory sync, and product import settings to control how PromoSync syncs promotional products to your Shopify store. - [Pricing Configuration](https://promosync-docs.psrestful.com/settings/pricing): Set global markup percentages, choose pricing tiers, and configure MAP enforcement for promotional products synced with PromoSync. - [Update Prices Schedule](https://promosync-docs.psrestful.com/settings/update-prices): How the Update Prices action works, why there is no "Twice a Day" option, and why Once a Week is the right default for most stores. - [Inventory & Scheduling](https://promosync-docs.psrestful.com/settings/inventory): Control how often PromoSync syncs supplier stock levels to Shopify and configure automatic inventory scheduling for your store. - [Discontinued Products](https://promosync-docs.psrestful.com/settings/discontinued-products): How PromoSync tracks supplier product status, stops updating discontinued products, and optionally prefixes their titles in Shopify. - [Product Import Settings](https://promosync-docs.psrestful.com/settings/product-import): Customize product titles, SKU formats, variant grouping, tags, and image handling when importing promotional products with PromoSync. - [Configurable Products](https://promosync-docs.psrestful.com/settings/configurable-products): Import kits, sets, and bundled promotional products (a plush toy with apparel, a tumbler with a color-matched straw, a multi-piece new-hire kit) as a single Shopify product with the correct variant options instead of a flat list of parts. - [Location Rules](https://promosync-docs.psrestful.com/settings/location-rules): Define tag-based default decoration rules so PromoSync can stamp locations and decoration methods onto products from suppliers that don't publish decoration data. - [Decoration Defaults](https://promosync-docs.psrestful.com/settings/decoration-defaults): Pin the pricing class your storefront charges for each decoration method and charge kind when a product has no per-product decoration pricing, used for SanMar / S&S Activewear-style blanks. - [Tier Pricing Rules](https://promosync-docs.psrestful.com/settings/tier-pricing-rules): Define tag-based default tier pricing so PromoSync can populate the tier-price array on products from suppliers that don't publish tier pricing, or to override the supplier's tiers with the distributor's own structure. - [Volume Pricing](https://promosync-docs.psrestful.com/settings/volume-pricing): Turn on the Quantity Price Breaks Shopify Function that automatically discounts cart lines down to the right tier price, and choose between per-variant and combined-by-product quantity grouping. ## Guides - [Guides Overview](https://promosync-docs.psrestful.com/guides): Step-by-step guides for importing products, syncing inventory, configuring pricing, and managing promotional products in your Shopify store. - [First-time Setup](https://promosync-docs.psrestful.com/guides/first-time-setup): What new merchants see when they open PromoSync for the first time, walked through the three-step onboarding wizard and what to do once it completes. - [Importing Products](https://promosync-docs.psrestful.com/guides/importing-products): Search, filter, preview, and import promotional products from 100+ suppliers into your Shopify store with PromoSync. - [Connecting Existing Products](https://promosync-docs.psrestful.com/guides/connecting-existing-products): Already have products in Shopify? Link them to supplier data with one click using Onboard to PromoSync so PromoSync can automatically sync inventory, pricing, and metafields. - [Product Life Cycle](https://promosync-docs.psrestful.com/guides/product-life-cycle): Understanding the 4-status product life cycle in PromoSync — draft, active, closeout, and discontinued — and how it helps you manage your Shopify catalog. - [Bulk Actions](https://promosync-docs.psrestful.com/guides/bulk-actions): Sync inventory, update prices, manage decorations, and refresh metafields across many products at once from Shopify Admin. - [Update Inventory](https://promosync-docs.psrestful.com/guides/bulk-actions/update-inventory): Pull fresh stock levels from your suppliers for the selected products and push them to Shopify in one tracked job. - [Update Prices](https://promosync-docs.psrestful.com/guides/bulk-actions/update-prices): Recalculate the visible Shopify variant price for the selected products using your current PromoSync pricing settings. - [Update Metafields](https://promosync-docs.psrestful.com/guides/bulk-actions/update-metafields): Refresh all PromoSync data on your products after changing a setting (like a pricing formula) without having to re-import them. - [Add New Variants](https://promosync-docs.psrestful.com/guides/bulk-actions/add-new-variants): Detect colors and sizes a supplier has added since you imported a product, and add them to your existing Shopify product without touching what is already there. - [Apply Default Decorations](https://promosync-docs.psrestful.com/guides/bulk-actions/apply-default-decorations): Stamp your tag-based default decoration rules onto selected products. Useful for suppliers that ship blanks without decoration data. - [Link to PromoSync](https://promosync-docs.psrestful.com/guides/bulk-actions/link-to-promosync): Register the selected Shopify products with PromoSync's backend so future syncs skip redundant API calls. - [Onboard to PromoSync](https://promosync-docs.psrestful.com/guides/bulk-actions/onboard-to-promosync): Bring pre-existing Shopify products under PromoSync's management by populating their PSRESTful metafields and registering them with the backend, in one tracked job. - [Enrich Location Decorations](https://promosync-docs.psrestful.com/guides/bulk-actions/enrich-location-decorations): Wire each decoration on a product to its matching Setup Fee and Run Charge product so checkout charges the imprint correctly. - [Decoration Listings](https://promosync-docs.psrestful.com/guides/decoration-listings): Publish supplier setup and run charges, with volume pricing, as Shopify products so you can bill imprint costs accurately in customer orders. - [Link to PromoSync](https://promosync-docs.psrestful.com/guides/link-to-promosync): Register existing Shopify products (including ones you duplicated) with PromoSync so future syncs skip redundant Shopify and PSRESTful API calls. - [Storefront Widgets](https://promosync-docs.psrestful.com/guides/storefront-widgets): Build tier pricing tables, decoration selectors, and other storefront widgets using PromoSync metafields and Shopify Liquid templates. - [Variant Media Gallery](https://promosync-docs.psrestful.com/guides/variant-media-gallery): Render color-matched, multi-image galleries per Shopify variant using PromoSync's psrestful.gallery metafield. Liquid examples, plan eligibility, and theme integration. - [Theme App Extensions](https://promosync-docs.psrestful.com/guides/theme-extensions): Add volume pricing, minimum quantity enforcement, and decoration selectors to your Shopify product pages with drag-and-drop app blocks — no code required. - [Volume Pricing (Display)](https://promosync-docs.psrestful.com/guides/theme-extensions/volume-pricing): Show quantity-based price breaks on your product pages with a drag-and-drop app block. No code or Liquid changes required. - [Volume Pricing Function](https://promosync-docs.psrestful.com/guides/theme-extensions/volume-pricing-function): The Shopify Function that automatically discounts cart lines down to the right tier price at checkout, powered by each variant's part_price_array metafield. - [Minimum Quantity](https://promosync-docs.psrestful.com/guides/theme-extensions/minimum-quantity): Prevent orders below minimum quantities by adding the PromoSync Minimum Quantity app block to your Shopify product pages. - [Decoration Selector](https://promosync-docs.psrestful.com/guides/theme-extensions/decoration-selector): Add a decoration location and method picker to product pages using the PromoSync Decorations app block for Shopify. ## Metafields - [Metafields Overview](https://promosync-docs.psrestful.com/metafields): PromoSync writes 70+ metafields to your Shopify products and variants — covering product data, pricing tiers, inventory, and Google Merchant fields. - [Product Metafields](https://promosync-docs.psrestful.com/metafields/product): Full reference for all product-level metafields PromoSync writes to Shopify, including descriptions, categories, pricing, and supplier data. - [Variant Metafields](https://promosync-docs.psrestful.com/metafields/variant): Full reference for variant-level metafields including size, color, weight, UPC, inventory, and pricing data synced by PromoSync. - [Google Merchant Fields](https://promosync-docs.psrestful.com/metafields/google-merchant): Reference for Google Merchant Center metafields PromoSync populates — optimize your Shopify products for Google Shopping campaigns. ## Advanced - [Advanced Overview](https://promosync-docs.psrestful.com/advanced): Explore advanced PromoSync capabilities — custom markup/discount pricing, multi-location inventory sync, and manufacturer mapping for complex fulfillment setups. - [Custom Pricing (MDP)](https://promosync-docs.psrestful.com/advanced/custom-pricing): Create per-supplier and per-brand markup or discount rules using PromoSync's MDP engine for precise pricing control. ## Optional - [Data Protection](https://promosync-docs.psrestful.com/data-protection-compliance): How PromoSync meets all 16 Shopify Protected Customer Data Access requirements across Level 1 and Level 2. - [Privacy Policy](https://promosync-docs.psrestful.com/privacy-policy): PromoSync Privacy Policy — how we collect, use, and protect your data when you use the PromoSync Shopify app. - [Incident Response Policy](https://promosync-docs.psrestful.com/security-incident-response): PromoSync security incident response policy — how we detect, respond to, and recover from security incidents affecting customer data.