> ## Documentation Index
> Fetch the complete documentation index at: https://amethystapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shipping Profile Automator Guide

Everything you need to know to install, configure, and automate your store's shipping organization.

# Shipping Profile Automator — Installation Guide

**Shipping Profile Automator** is a streamlined utility designed to eliminate the manual work of organizing your catalog. By using high-performance rules, it ensures your products are always assigned to the correct shipping profiles or groups the moment they are created or updated.

***

## Key Capabilities at a Glance

* **Real-Time Automation:** Products are re-assigned instantly via platform webhooks when tags, vendors/brands, or prices change.
* **Smart Rules Engine:** Create complex logic using **Title, Vendor/Brand, Product Type, Tag, SKU, or Price**.
* **Priority Matching:** "First-match wins" logic allows you to stack specific rules over general ones.
* **Daily Safety Sweep:** A scheduled daily sync catches any edge cases and keeps your catalog 100% accurate.
* **Dry Run Mode:** Preview exactly which products will move before committing to any changes.
* **Audit Trail:** Detailed logs show you exactly why a product matched a specific rule and which variants were moved.
* **Bulk Execution:** Move your entire catalog to the correct profiles with a single click.

***

## Step 1: Install the App

Visit the **Shopify App Store** or **BigCommerce App Marketplace** and search for **Shipping Profile Automator**. Click **Install** and approve the required permissions to allow the app to manage your product assignments and shipping settings.

<a href="https://apps.shopify.com/partners/amethyst-apps" class="btn-amethyst-install">
  View App Details & Install →
</a>

> **Note:** The app requires write access to modify your shipping assignments. We never modify your product titles, descriptions, or prices.

## Step 2: Sync Your Profiles

Once installed, the app needs to "learn" your current shipping setup.

1. Navigate to the **Dashboard**.
2. Click the **Sync Profiles** button.
3. The app will pull your existing Shipping Profiles or Groups into the local cache so you can use them in your rules.

## Step 3: Create Your Automation Rules

This is where the magic happens. Head to the **Shipping Rules** tab to build your logic:

1. **Name & Priority:** Give your rule a name (e.g., "Heavy Items") and set its priority. **Priority 1** is evaluated first.
2. **Select Target:** Choose which shipping profile or group products should move to when they match.
3. **Set Conditions:** \* Choose a field (e.g., **Tag**).
   * Choose an operator (e.g., **Contains**).
   * Enter a value (e.g., `heavy-shipping`).
4. **Logic Type:** Choose **AND** (all conditions must be true) or **OR** (any condition can be true).

***

## Step 4: Run a Dry Run (Recommended)

Before turning on live automation, test your rules safely:

1. On the Dashboard, click **Dry Run Sweep**.
2. The app will evaluate your entire catalog against your rules but **will not** move anything in your live store admin.
3. Check the **Automation Logs** to see the "Matched" results. If the results look perfect, you’re ready to go live.

## Step 5: Enable Live Automation

Once you are happy with your rules:

1. Ensure your rules are toggled to **Enabled**.
2. From this moment on, any product created or edited in your store admin will be automatically processed.
3. To fix your existing catalog immediately, click **Run Full Sweep**.

***

## Advanced Features

* **Manual Reordering:** Use the arrows on the Rules page to change which rules take precedence.
* **Log Retention:** We keep a detailed 30-day history of every move for your peace of mind.
* **Automatic Retries:** If a platform API is busy or down, our system automatically retries the move until it succeeds.

***

### Requirements

* **Platform:** Works on all **Shopify** and **BigCommerce** plans.
* **Setup:** No theme code or Liquid/Stencil snippets required.
* **Billing:** All billing is handled natively through your respective platform (**Shopify Admin** or **BigCommerce Billing**).

<div class="glass-callout">
  ### Need Help?

  Not sure how to structure your logic or need help with a complex shipping setup? Our team is here to help you get automated.
  [Contact Support](mailto:support@amethystapps.com)
</div>

<br />

<a href="https://apps.shopify.com/partners/amethyst-apps" class="btn-amethyst-install">
  Start Automating Your Shipping →
</a>