Importing Products

This guide walks you through finding and importing promotional products from PromoStandards suppliers into your Shopify store.

Overview

PromoSync connects to 100+ promotional product suppliers through the PSRESTful API. You can search their combined catalogs, preview products, and import them directly to Shopify with your configured pricing and settings.

Your First Import

Step 1: Access the Import Screen

1. Open your Shopify admin
2. Navigate to Apps > PromoSync
3. Click Import Products in the main navigation

Step 2: Search for Products

Enter search terms in the search bar:

• Product type: “t-shirt”, “polo”, “hoodie”
• Brand: “Bella Canvas”, “Gildan”
• Part ID: “3001”, “G500”

Click Search or press Enter.

Step 3: Review Results

The search results show:

• Product image thumbnail
• Product name and part ID
• Brand and supplier
• Price range
• Available colors/sizes

Step 4: Preview a Product

Click on any product to see:

• All product images
• Complete pricing tiers
• Available variants (colors and sizes)
• Inventory levels
• Product specifications

Step 5: Import the Product

1. Click Import to Shopify
2. Confirm the import settings
3. Wait for the import to complete
4. Click View in Shopify to see your new product

Filtering Products

Filtering by Supplier

Import products from specific suppliers:

1. Click Filters on the search results page
2. Under Supplier, select one or more suppliers
3. Click Apply Filters

Popular suppliers:

• SanMar
• alphabroder
• S&S Activewear
• Hit Promotional Products
• PCNA

Filtering by Brand

Find products from specific brands:

1. Click Filters
2. Under Brand, type or select brand names
3. Click Apply Filters

Examples:

• BELLA+CANVAS
• Gildan
• Champion
• The North Face
• Nike

Filtering by Category

Browse by product category:

1. Click Filters
2. Under Category, select categories
3. Click Apply Filters

Common categories:

• T-Shirts & Tanks
• Polos & Knits
• Outerwear
• Headwear
• Bags
• Drinkware

Combining Filters

Apply multiple filters simultaneously:

Supplier: SanMar
Brand: The North Face
Category: Outerwear
Search: "softshell"

This finds The North Face softshell jackets available from SanMar.

Bulk Import

Selecting Multiple Products

1. Check the box next to each product you want to import
2. Or click Select All to select all visible results
3. The selection count appears at the top

Importing Selected Products

1. With products selected, click Import Selected
2. Review the import summary:
   • Number of products
   • Total variants
   • Estimated images
3. Click Confirm Import
4. Monitor the progress indicator

Import Queue

For large imports, products are queued:

{
  "queueStatus": {
    "total": 25,
    "completed": 12,
    "inProgress": 1,
    "pending": 12,
    "failed": 0
  }
}

You can navigate away - imports continue in the background.

Import Options

Per-Import Settings

Override default settings for specific imports:

Skip Existing Products

By default, PromoSync skips products already in your store (matched by part ID). You can:

• Skip - Don’t reimport (default)
• Update - Update existing product data
• Duplicate - Create a new product

Managing Import History

Viewing Import History

1. Navigate to PromoSync > History
2. See all past imports with:
   • Date and time
   • Product count
   • Success/failure status
   • Who triggered the import

Retrying Failed Imports

If products fail to import:

1. Click on the failed import in history
2. Review the error details
3. Click Retry Failed Products

Common errors:

• Rate limit exceeded - Wait and retry
• Invalid image URL - Check with supplier
• Variant limit exceeded - Use variant grouping

Import Performance

Estimated Times

Times vary based on:

• Number of images
• Variant complexity
• Supplier response time
• Shopify API limits

Optimization Tips

1. Import during off-peak hours - Faster supplier responses
2. Use filters - Only import what you need
3. Batch similar products - Better caching
4. Check inventory first - Avoid importing out-of-stock items

Verifying Imports

After Import Checklist

✓ Product appears in Shopify ✓ All variants are present ✓ Images loaded correctly ✓ Pricing is accurate ✓ Inventory levels are set ✓ Metafields are populated

Viewing Synced Products

1. In PromoSync, go to Products
2. Filter by Synced status
3. See all products managed by PromoSync

Checking Sync Status

Each synced product shows:

• Last sync time
• Sync status (success, pending, error)
• Supplier connection status

Troubleshooting

No Search Results

1. Check your search terms - try broader terms
2. Verify your PSRESTful subscription includes the supplier
3. Check supplier availability in your region
4. Try filtering by supplier first, then searching

Import Fails

Incorrect Data

If imported data doesn’t match expectations:

1. Check your import settings (title format, pricing, etc.)
2. Compare with PSRESTful API directly
3. Verify supplier data in their portal
4. Contact support with specific examples

Next Steps

After importing products:

1. Configure storefront widgets - Display tier pricing and more
2. Set up inventory sync - Keep stock levels current
3. Review bulk actions - Manage products efficiently