Connect Existing Collection (recommended for SEO)

If you already have a sale or clearance collection that ranks in search results, is linked in ads, or appears in your email campaigns — connecting it to StockSweep avoids breaking that URL and preserves your SEO equity.

Estimated time: 8–12 minutes

What you'll accomplish

• Link your existing Shopify collection to StockSweep (instead of creating a new one)
• Ensure your collection rules match the tags StockSweep applies
• Verify the full cycle: discount → tag → collection → revert → cleanup
• Preserve your existing URL, backlinks, and search rankings

Requirements

• You already have a sale/clearance collection in Shopify
• The collection must be a Smart Collection (rule-based), not a Manual Collection
• Auto-tagging is enabled in Settings → Sale Collections

Why link an existing collection (instead of auto-creating)

Recommendation: if you have an existing sale collection with any SEO history or external links, always link to it instead of creating a new one.

Step-by-step setup

1. Go to Settings → Sale Collections

Open the collection settings page in StockSweep.

2. Choose "Use existing collection"

In the Collection mode setting, select "Use existing collection" instead of "Auto-create new".

3. Select your collection from the dropdown

StockSweep shows a dropdown of all your Shopify collections. Select your existing sale/clearance collection.

The dropdown shows a preview for each collection:

• Current product count
• Collection URL handle
• Whether it is a Smart Collection or Manual Collection

Important: only Smart Collections (rule-based) work with auto-tagging. If your collection is a Manual Collection, you need to convert it to a Smart Collection first in Shopify Admin.

4. Match the tag to your collection rule

Ensure the primary tag configured in StockSweep matches the rule in your Smart Collection.

Example:

• StockSweep primary tag: clearance
• Smart Collection rule: "Product tag is equal to clearance"

If they do not match, either:

• Change the primary tag in StockSweep to match your existing rule, OR
• Update the Smart Collection rule in Shopify Admin to match the StockSweep tag

Tags must match exactly (case-sensitive, no extra spaces).

5. Keep the handle stable

Your collection URL is based on its handle (e.g., /collections/sale or /collections/clearance). Do not change the handle — this is the URL that search engines and your marketing materials point to.

6. Save settings

Click Save. StockSweep will now use your existing collection for all auto-tagging operations.

Preview before linking

Before saving, the settings page shows a preview:

• Current product count in the collection (before StockSweep manages it)
• Estimated product count after linking (based on currently discounted items with the matching tag)
• Warnings if the existing collection has conflicting rules (e.g., multiple rules that might include unrelated products)

Review the preview to confirm you are not accidentally adding unexpected products to the collection.

Validate with a small test

After linking, run this test to confirm the full cycle works:

1. Apply a test discount

Select 2–3 items from the Dead Stock Table and apply a 10% discount.

2. Confirm the tag appears

Open one discounted product in Shopify Admin → Products → Tags. Confirm the primary tag (e.g., clearance) is present.

3. Confirm the product appears in your collection

Open your existing collection in Shopify Admin → Collections. The discounted product should appear.

4. Check the storefront

Visit your collection page on the storefront (e.g., yourstore.com/collections/sale). The product should be visible with the "Was $X, Now $Y" strikethrough.

5. Revert and confirm cleanup

Revert the test discount and confirm:

• The tag is removed from the product
• The product disappears from the collection
• The storefront page no longer shows the item

What success looks like

• Your existing collection URL stays unchanged — no SEO impact, no broken links
• Discounted items reliably appear in the collection immediately after discount
• Reverted items reliably leave the collection (immediately if "Remove on revert" is enabled, or by the 4:00 AM daily cleanup job)
• The collection preview in StockSweep settings shows an accurate product count and last sync time

Troubleshooting (symptom-first)

"My sale page URL changed"

Likely cause: the collection handle was edited in Shopify Admin, or StockSweep auto-created a new collection instead of linking. Fix: check Settings → Sale Collections and confirm "Use existing collection" is selected with the correct collection. If the handle changed, revert it in Shopify Admin → Collections → Edit. Set up a Shopify URL redirect from the old handle to the new one if needed. How to confirm: the collection URL matches the handle you want to keep (e.g., /collections/sale).

"Items don't appear in my collection after discount"

Likely cause: the tag StockSweep applies does not match the Smart Collection rule, or the collection is a Manual Collection (not rule-based). Fix: compare the StockSweep primary tag with the exact rule in your Smart Collection. Ensure the collection type is "Smart Collection" in Shopify Admin. How to confirm: the product has the correct tag AND the collection rule matches it exactly.

"Items don't leave the collection after revert"

Likely cause: "Remove tag on revert" is disabled in StockSweep settings, the tag was also added manually outside StockSweep, or the daily cleanup job has not run yet. Fix: enable "Remove tag on revert" in Settings → Sale Collections. Check if the tag has other sources. Wait for the 4:00 AM cleanup job if the real-time cleanup missed it. How to confirm: the product tag is removed and it no longer appears in the collection.

"My collection shows products that weren't discounted by StockSweep"

Likely cause: other apps or manual actions are adding the same tag to products. Fix: use a unique tag that is only managed by StockSweep (e.g., stocksweep-clearance instead of a generic sale). Update both the StockSweep primary tag setting and the Smart Collection rule to match. How to confirm: only StockSweep-discounted products have the tag.

"Dropdown doesn't show my collection"

Likely cause: the collection may have been deleted or the Shopify API connection needs to refresh. Fix: confirm the collection exists in Shopify Admin. Try refreshing the StockSweep settings page. How to confirm: the collection appears in the dropdown after refresh.

FAQ

Can I switch from auto-create back to an existing collection later?

Yes. Change the collection mode in Settings → Sale Collections at any time. Existing tags on products are not affected by the switch — products will continue to appear in whichever collection's rules match.

What happens to the auto-created collection if I switch to an existing one?

The auto-created collection remains in Shopify but is no longer managed by StockSweep. You can delete it manually in Shopify Admin if you no longer need it.

Can I use a Manual Collection instead of a Smart Collection?

No. StockSweep uses tags to manage collection membership automatically, and only Smart Collections support tag-based rules. Convert your Manual Collection to a Smart Collection in Shopify Admin before linking.

Related articles

• Auto-tagging & Sale Collection (how it works)
• Apply Discount (step-by-step + safety notes)
• Revert Discount (undo safely)