Product Import Settings

Configure how products are created in Shopify when importing from suppliers. These settings affect product titles, SKUs, variant organization, tags, and images.

Title Format

Available Formats

Custom Title Format

Use placeholders to create custom title formats:

Example custom format:

{brand} {product_name} - Style {part_id}
→ BELLA+CANVAS Unisex Jersey Tee - Style 3001

Setting Title Format

1. Navigate to Settings > Product Import
2. Select Title Format
3. Choose a preset or enter a custom format
4. Click Save

SKU Strategies

Available Strategies

PromoSync offers 7 SKU generation strategies:

Custom SKU Format

Create custom SKU formats with placeholders:

Example:

{prefix}-{part_id}-{color_code}-{size_code}
→ ABC-3001-BLK-L

SKU Configuration

1. Go to Settings > Product Import
2. Select SKU Strategy
3. For custom, enter your format and prefix
4. Click Save

Variant Grouping

Control how product variants are organized in Shopify.

Grouping Strategies

Single Grouping

All variants appear as one product:

Product: Unisex Jersey Tee
├── Black / S
├── Black / M
├── Black / L
├── White / S
├── White / M
├── White / L
└── (etc.)

By Color Grouping

Creates separate products per color:

Product: Unisex Jersey Tee - Black
├── Black / S
├── Black / M
└── Black / L

Product: Unisex Jersey Tee - White
├── White / S
├── White / M
└── White / L

Split Limit Grouping

Splits products when variants exceed a threshold:

{
  "strategy": "split_limit",
  "limit": 100,
  "splitBy": "color"
}

Shopify’s variant limit is 100. Use this strategy for products with many combinations.

Shopify Taxonomy Category

PromoSync can map each imported product to Shopify’s built-in product taxonomy so it lands in the right category for search, filtering, and Shop Pay. The category is derived from the supplier’s PromoStandards classification data, so no manual taxonomy picking is required.

When eligible, PromoSync sets the product’s category (Shopify’s TaxonomyCategory GID) at import time. If the supplier did not classify the product, or did not provide a Shopify-compatible classification, the field is left unset and Shopify falls back to its own auto-categorization.

To upgrade your plan, visit psrestful.com/pricing.

Color Swatches

PromoSync can render native Shopify color swatches by linking each color option to a custom-color-swatch metaobject populated from PromoStandards color data (label and hex). Themes that support metaobject-linked options will then display real swatches in the variant picker instead of plain text.

When the feature is active for a shop, PromoSync ensures the required metaobject and metafield definitions exist (creating them on first import if missing) and upserts one color metaobject per unique color encountered in the catalog. The color metaobject definition lives at custom-color-swatch with label and hex_color fields and is exposed to the storefront so Liquid can read it.

Color swatches need the write_metaobjects and write_metaobject_definitions OAuth scopes. When a shop is promoted into a plan that grants the feature, PromoSync triggers the standard scope-change banner so the merchant can re-authorize before the next import runs.

To upgrade your plan, visit psrestful.com/pricing.

Tag Management

Automatic Tags

PromoSync can automatically add tags based on product attributes:

Tag Configuration

1. Go to Settings > Product Import
2. Enable/disable each tag type
3. Configure tag format (with or without prefix)
4. Click Save

Custom Tags

Add custom tags to all imported products:

promostandards, synced, {supplier}

Vendor Settings

Vendor Assignment

Choose how the Shopify vendor field is populated:

Product Type Assignment

Set the Shopify product type:

Image Import Settings

Image Options

Image Order

Configure the order of imported images:

{
  "imageOrder": [
    "primary",
    "front",
    "back",
    "detail",
    "lifestyle"
  ]
}

Image Alt Text

Automatically generate alt text:

{product_name} - {color} - View {position}
→ Unisex Jersey Tee - Black - View 1

Variant Options

Option Names

Customize variant option labels:

Option Order

Set the order of variant options:

{
  "optionOrder": ["Color", "Size"],
  "colorFirst": true
}

Size Normalization

Normalize size values across suppliers:

Description Settings

Description Format

Choose what to include in product descriptions:

HTML Formatting

Enable rich HTML in descriptions:

<div class="product-description">
  <p>{{ description }}</p>
  <h3>Features</h3>
  <ul>
    {% for feature in features %}
    <li>{{ feature }}</li>
    {% endfor %}
  </ul>
</div>

Weight and Dimensions

Unit Settings

Default Values

Set defaults when supplier data is missing:

{
  "defaultWeight": 0.5,
  "defaultWeightUnit": "lb",
  "requireWeight": false
}

Import Preview

Before importing, preview how products will appear:

// Import preview
{
  "title": "BELLA+CANVAS Unisex Jersey Tee - Style 3001",
  "vendor": "Bella+Canvas",
  "productType": "T-Shirts",
  "tags": ["supplier:bella-canvas", "brand:bella-canvas", "category:t-shirts"],
  "variants": 45,
  "images": 8,
  "price": "$14.99",
  "sku": "3001-BLK-S"
}

Applying Settings to Existing Products

Settings apply to new imports by default. To update existing products:

1. Select products in PromoSync
2. Choose Bulk Actions > Reapply Import Settings
3. Select which settings to reapply
4. Confirm the operation

Best Practices

1. Test with one product - Import a single product to verify settings
2. Use consistent SKUs - Choose a strategy and stick with it
3. Optimize for SEO - Include relevant keywords in titles
4. Control variant count - Use grouping to manage large catalogs
5. Tag strategically - Enable tags that help with collections and filtering