How to use Scrapit

Installation

Scrapit is a native Shopify app — it lives directly inside your Shopify Admin. Installation takes about two minutes.

Data safety and permissions

• Scrapit only requests the permissions needed for product catalog import and sync workflows in your Shopify admin.
• The app is focused on catalog operations inside your Shopify admin.
• For policy details, see Privacy Policy and Terms of Service.

Your First Import

Importing your first product takes under a minute. Here's how:

Setting Up AI Scraping

AI scraping helps with difficult pages (JavaScript-heavy storefronts, unusual layouts, and inconsistent product markup) and supports both Google Gemini and OpenAI providers.

Getting an API key

• Gemini: Go to aistudio.google.com, sign in with your Google account, and create an API key.
• OpenAI: Go to platform.openai.com/api-keys, sign in, and create a new secret key.
• Copy the key immediately after creation — it is only shown once. Store it somewhere safe before pasting it into Scrapit.

Adding your key in Scrapit

• Go to Settings → AI.
• Select your active provider (Gemini or OpenAI).
• Paste your key and click Save; Scrapit validates it immediately.

Once your provider is connected, you can use AI Scrap It during imports on Pro. See Free vs Pro Matrix for plan gates.

Single Product Import

The single import flow is Scrapit's core feature. It handles one product URL at a time with a full preview before importing.

What gets imported

• Title — cleaned and ready
• Description — full HTML body
• Images — all product images, in order
• Variants — size, colour, and other options with their own prices, including disabled or unavailable source variants (Scrapit does not skip them)
• Price & compare-at price
• Product type & tags — auto-mapped to Shopify's taxonomy

Re-importing an existing product

If a product from the same source URL already exists in your store, Scrapit detects it and offers a smart merge — updating changed fields while preserving your custom edits (like adjusted prices or custom variant names).

Bulk / Collection Import

Bulk import lets you scrape an entire category or collection page and import multiple products at once. Available on Free and Pro plans.

Advance Linking

Advance Linking helps you match imported source products with existing Shopify products. It is designed for merchants who want tighter control over re-linking and future updates.

How plan access works

• Free: You can open the page, fetch products, and review suggestions.
• Pro: Required to save new links using Re Linking.
• Unlinking: Existing links can still be removed when sent in the request flow.

AI Scrap It

AI Scrap It improves difficult imports by generating cleaner product data and SEO content with AI.

Providers and setup

• Scrapit supports Google Gemini and OpenAI through Settings → AI.
• Configure defaults in Settings and override options per import session.

Important behavior to know

• AI imports are one-time imports — products created with AI Scrap It are not tracked for future sync by Scrapit.
• No auto-sync lifecycle — they do not appear in the normal synced product pipeline unless later imported through regular import flows.
• Import limits — successful AI imports count toward the monthly caps in Import Limits.

Sync Engine

The Sync Engine keeps imported products up to date with source data, with different actions available by plan.

What gets synced

• Price changes (with your markup rules applied)
• New product images
• Variant options and availability from the source (same inclusion rules as single import)
• Description updates

Plan access and frequency

• Single-product sync: Available on Free and Pro.
• Sync all products (bulk): Pro only.
• Auto-sync interval options: 6, 12, 24, 48, or 72 hours in Settings → Sync.

Pricing Rules

Pricing rules let you automatically adjust and transform prices when importing and syncing. Configure them in Settings → Pricing.

Price pipeline

Scrapit applies pricing rules in this order: Markup % → Currency conversion rate → Price rounding. All three are optional — leave any field empty to skip that step.

• Markup % — percentage uplift applied to every variant price. For example, enter 20 to add 20% on top of the source price.
• Currency conversion rate — multiplier applied after markup. Useful when the source store uses a different currency (e.g. PKR → USD: enter the conversion rate as a decimal).
• Price rounding — applied after markup and conversion. Choose from:
  • No rounding — keep the calculated price as-is
  • Round to nearest whole — e.g. $56.13 → $56.00
  • Always round up — e.g. $56.13 → $57.00
  • Always round down — e.g. $56.13 → $56.00
  • Psychological .99 — e.g. $56.13 → $55.99
  • Psychological .95 — e.g. $56.13 → $55.95
  • Nearest .50 — e.g. $56.13 → $56.50

Re-import pricing behaviour

• Always update source price on re-import — when enabled, the raw source price is always written on re-import. When disabled, price is never touched on re-import regardless of any other setting.
• Also apply pricing rules on re-import — when enabled, your markup, conversion rate, and rounding are also applied during re-imports, not just on first import.

Sync pricing behaviour

• Apply price settings on sync — when enabled, your markup and rounding are re-applied every time a product syncs. When disabled, the raw source price is pushed directly without any transformation.

Import Settings

Control what gets imported by default. Found under Settings → Import. All options apply to new imports; some also apply on re-import and sync depending on your other settings.

Product status & title

• Import status — set imported products to Draft (review before publishing) or Active (publish immediately).
• Title prefix — text prepended to every imported product title (e.g. [Imported]). Re-applied on sync when the title sync & affix toggle is on.
• Title suffix — text appended to every imported product title. Same sync behaviour as prefix.

Vendor & collection

• Vendor override — when set, replaces the vendor scraped from the source store. Leave blank to keep the original vendor name.
• Assign to collection — add imported products to a specific Shopify collection automatically. You can create a new collection directly from this setting without leaving Scrapit.

Tags

• Append tags — comma-separated tags merged into every imported product (e.g. scrapit, supplier-x).
• Strip source tags — when enabled, all tags scraped from the source store are discarded. Only your appended tags (if any) are written to the product.

Custom description injection

Add fixed text into every imported product description — useful for sourcing disclosures, dropship notes, or brand copy.

• Enable — toggle the feature on or off without losing your saved text.
• Description text — the content injected into the product description on every import and on sync when description sync is enabled.
• Inject position — choose where the text is placed:
  • Add at the beginning — prepended before the scraped description
  • Replace description — replaces the scraped description entirely
  • Add at the end — appended after the scraped description

Inventory Settings

Control how inventory is set on imported products and how it is updated during sync. Found under Settings → Inventory. There are two independent cards, each with its own Save button.

Import inventory rules

These rules run when a product is first imported or re-imported.

• Default initial inventory — a fixed quantity applied to every variant on import. When set, this replaces the scraped stock level (which is typically unavailable anyway).
• Also apply inventory settings on re-import — when enabled, the default quantity above is also written during re-imports, not just on first import.
• Append to existing inventory — when enabled, the default quantity is added on top of the current Shopify stock rather than replacing it (e.g. current = 12, default = 12 → result = 24).
• Only set quantity at products with 0 inventory — when enabled, the inventory write is skipped unless the product's current stock is already zero.
• Always update sourced inventory on re-import — master gate. When disabled, inventory is never written on re-import regardless of any other setting above.

Inventory sync rules

These rules run each time a tracked product syncs. They are completely independent from the import rules above.

• Apply inventory settings to sync — master toggle for this card. Must be on for any of the rules below to take effect.
• Inventory buffer — a fixed quantity applied to all variants on sync. When both append and only-zero are off, this value replaces the current stock. When append is on, it is added on top of the source quantity (e.g. source = 2, buffer = 5 → result = 7).
• Append buffer to source inventory — adds the buffer on top of the source store quantity rather than replacing it.
• Only update products with 0 source inventory — when enabled, the inventory write during sync is skipped unless the source quantity is zero.

Sync Settings

Control which fields get updated when a product syncs and configure automatic sync schedules. Found under Settings → Sync. There are two independent cards, each with its own Save button.

Sync fields

Toggle exactly which parts of a product Scrapit overwrites during sync. Uncheck any field to preserve your manual edits for that field indefinitely.

• Title — overwrites the product title with the latest from the source store. Your title prefix and suffix (from Import Settings) are re-applied if the affix toggle below is on.
• Apply title prefix & suffix during sync — sub-toggle under Title. When off, your prefix/suffix are not re-applied, letting you freely edit the final title format without it being reset on the next sync.
• Description — overwrites the product body HTML with the latest from the source store. Your custom description injection (from Import Settings) is also re-applied if it is enabled.
• Images — adds new images from the source store. Existing images on your product are never removed, only new ones are appended.
• Price — updates variant prices from the source. If Apply price settings on sync is enabled in Pricing Settings, your markup and rounding are also re-applied; otherwise the raw source price is used.
• Inventory quantity — updates stock levels according to your Inventory Sync Rules (see Inventory Settings). Hidden source counts are always skipped.
• Variants — syncs variant options and availability from the source. Source variants are always kept in sync; your manually added custom variants are preserved or replaced depending on your Advanced Settings.

Auto-sync schedule

Available on Pro only. Auto-sync runs store-wide sync for all tracked products on a repeating schedule without you having to trigger it manually.

• Enable auto-sync — turns the scheduled job on or off.
• Sync interval — how often the job runs. Options: every 6, 12, 24, 48, or 72 hours.

AI Settings

Manage provider keys, model selection, and default AI feature behaviour under Settings → AI. For provider billing and plan gates, see Setting Up AI Scraping and Free vs Pro Matrix.

Provider & API keys

• Active provider — choose Gemini or OpenAI as your active provider. Only one provider is used at a time; switching is instant and saved automatically.
• API key — paste your key and click Save. Scrapit validates the key immediately and shows its status (Active, Invalid, or not set).
• Key storage — keys are encrypted with AES-256-CBC before storage. After saving, the raw key is never shown or returned to the browser.
• Remove key — clears the stored key for that provider without affecting the other provider.

Model selection

Each provider lets you choose which model Scrapit uses for AI generation. The model is saved per-provider.

• Gemini models: Gemini 2.5 Pro (best quality), Gemini 2.0 Flash (recommended — fast), Gemini 2.0 Flash-Lite (fastest), Gemini 1.5 Flash (legacy fast), Gemini 1.5 Pro (legacy quality).
• OpenAI models: GPT-4.1 Mini (recommended — fast & affordable), GPT-4.1 (higher quality), o4-mini (reasoning), GPT-4o Mini (legacy fast), GPT-4o (legacy quality), GPT-4 Turbo (legacy).

AI feature toggles

Two separate cards let you configure which fields AI generates by default. Each card has its own Save button and requires an active API key.

• AI Title Generation — rewrite product titles to be more descriptive and SEO-friendly.
• AI Description Generation — generate rich HTML product descriptions from scraped data.
• AI Collection Mapping — use AI to assign products to Shopify collections during import.
• AI Category Mapping — automatically map products to Shopify product categories using AI.
• AI Tags Generation — generate relevant product tags from the scraped product context.

SEO feature toggles

• AI SEO Title Generation — generate optimised SEO page title text for search results.
• AI SEO Description Generation — generate SEO meta descriptions for imported products.
• AI SEO Handle Generation — generate a clean URL handle for the product page.

Advanced Settings

Use Settings → Advanced for fine-grained control over how re-import and sync handle your custom variants, as well as banner preferences and maintenance tools. There are four independent cards, each with its own Save button.

Re-import variant preservation

Controls what happens to variants you have manually added to a product in Shopify when that product is re-imported from the source.

• Replace custom variants on re-import — when on, re-importing replaces all variants with the latest source data, including removing any variants you added manually. When off, your manually added variants are kept alongside the updated source variants.
• Apply inventory settings to preserved variants — only affects your manually added variants. When on, the inventory rules from Inventory Settings are also applied to your custom variants on re-import. When off, custom variant stock levels are left completely untouched.
• Apply price settings to preserved variants — only affects your manually added variants. When on, each custom variant inherits the price of the nearest preceding source variant (with markup applied). Source store variants are always updated regardless.

Sync variant preservation

Identical controls to re-import preservation, but applied during sync. These rules are fully independent — you can configure re-import and sync behaviour differently.

• Replace custom variants on sync — when on, syncing replaces all variants with the latest source data including your manual additions. When off, your custom variants are kept.
• Apply inventory settings to preserved variants — applies inventory sync rules to your manually added variants during sync.
• Apply price settings to preserved variants — applies price sync rules to your manually added variants during sync.

Banner preferences

Toggle helper banners that appear during imports to flag potential data issues.

• Show hidden inventory warning — displays a banner when the source store hides its inventory counts, so you know the scraped stock levels may be unreliable.
• Show currency mismatch warning — displays a banner when the source store currency differs from your store currency, prompting you to set a conversion rate in Pricing Settings.

Fix inventory location

A one-time maintenance tool. If your Shopify inventory location changed after products were already imported, this button re-assigns all tracked product inventory to your current active location. Safe to run at any time — it is idempotent.

Import Limits

Scrapit uses monthly import limits that reset each calendar month (UTC):

• Free: 15 imports or updates per month
• Pro: 500 imports or updates per month (fair use)
• The same monthly counter applies across Single Import, Bulk Import, and AI Scrap It imports.
• Only successful new imports and real updates count; skipped no-change events do not increase usage.

Free vs Pro Matrix

Quick reference for the most important feature gates:

• Single import: Free and Pro
• Bulk/collection import: Free and Pro
• AI Scrap It import action: Pro only (settings/setup visible on all plans)
• Advance Linking save (Re Linking): Pro only (fetch/review UI still usable on Free)
• Sync single product: Free and Pro
• Sync all products (bulk): Pro only

In the app, open Settings → Billing and choose App Limitations & Tips to review the same product limitations and guidance shown on first visit (Free users may see it once automatically).

Syncing Page

The Syncing page is your operational sync control center.

Main areas

• Sync All card — run store-wide sync for tracked products (Pro only).
• Sync Specific — search and sync individual products (all plans).
• Sync Issues table — review products in error/paused states, then re-sync, remove from list, or delete from Shopify.

Logs Page

The Logs page gives a read-only activity timeline across core workflows.

• Import logs — import attempts and outcomes
• Advance Linking logs — linking/unlinking batch actions
• AI usage logs — AI feature calls and outcomes
• Sync logs — sync attempts, status, and errors

Common Issues

URL points to the wrong flow

If you paste a collection URL in Single Import (or a product URL in Bulk), Scrapit can auto-route you to the correct tab.

Non-Shopify source URL

Scrapit only scrapes Shopify-powered stores. See Your First Import.

Inventory not updating from the source

Source stock levels are not scraped or synced. See Inventory Settings.

AI import blocked on Free

See Free vs Pro Matrix and upgrade from Settings → Billing if needed.

Advance Linking cannot save links

Saving new links requires Pro. See Free vs Pro Matrix.

Sync All unavailable

Bulk sync is Pro-only. See Free vs Pro Matrix.

Quota reached

See Import Limits for monthly caps and reset timing.

AI provider or rate limit errors

Re-check your API key in Settings → AI, verify provider billing/credits, then try again.

Best Practices

• Start imports as Draft while testing new suppliers or categories.
• Run a small batch first, review pricing and variant results, then scale up.
• Set pricing rules before bulk imports so product prices are consistent from day one.
• Use Advance Linking for products that need long-term source-to-store mapping control.
• Check Sync Issues and Logs weekly to catch supplier or mapping changes early.

FAQ

Why did my import fail?

Most failures come from invalid URLs, temporary source-store issues, quota limits, or AI provider key/credit problems. Re-check the URL and plan gates first, then review Logs.

Can I import from WooCommerce, Wix, or BigCommerce?

No. Scrapit scrapes products from Shopify-powered source stores only.

Why is Sync All disabled?

See Free vs Pro Matrix.

Why can I open AI Scrap It but cannot import?

See Free vs Pro Matrix.

Does AI Scrap It create synced products?

No. AI Scrap It is a one-time import flow and does not create the regular tracked sync lifecycle by itself.

Do logs affect my monthly import quota?

No. See Import Limits.

Need Help Fast

For quickest support, use the Contact page and include:

• Your Shopify store domain
• The exact source URL you used
• A screenshot (or short screen recording) of the error
• Whether this happened in Single, Bulk, AI Scrap It, Advance Linking, or Syncing

Reviews & Feedback

Scrapit may show a short in-app prompt after successful usage milestones.

• Happy with results: you can leave an App Store review directly.
• Not satisfied yet: send quick feedback so the team can improve the product.
• Dismissed prompt: it stays hidden for the rest of the current month.