Getting Started

Work through this list once, top to bottom. After step 12 your first optimised texts are live in Shopify; budget roughly an hour, excluding the bulk run itself.

1. Create your account and connect your shop
   Create your account and go to Settings → Shopify. In your Shopify admin, create a Custom App (Apps → App and sales channel settings → Develop apps), grant the Admin API scopes for products, collections, files, themes and redirects, then paste the access token and your *.myshopify.com URL into Pshly. Use the installation guide if you get stuck.
   Done when: the connection shows a green status and your store name.
2. Import products and collections
   Click Import on the dashboard. Pshly pulls in titles, descriptions, tags, images, variants and metafields. Check that the product and collection counts match Shopify; run a Refresh if they don't.
   Done when: the dashboard counters match your Shopify catalog.
3. Fill in your company information
   Under Settings → Company, enter your company name, target audience, USPs, shipping and returns policy and your website domain. This information is included in every AI prompt, so the sharper it is here, the less you'll correct later.
   Done when: all fields are filled in and the domain has no typos.
4. Set writing style and language
   Under Settings → Content, choose the tone of voice, desired length, content language (per market if you use Shopify Markets) and fill in your do's and don'ts. Add filler words you never want to see (e.g. elegant, stylish, luxury) to the banned-words list; Pshly then strips them from titles and SEO titles automatically.
   Done when: a test text sounds like your brand, without filler words.
5. Review SEO settings
   Set the templates for SEO title and meta description, and decide whether Pshly may suggest internal links. This is also where you enable or disable URL handle optimisation: for active products, Pshly automatically creates a 301 redirect in Shopify when a handle changes, so you don't lose link equity.
   Done when: you know which SEO fields Pshly overwrites and whether handles may change.
6. Metafields and category mapping
   Under Settings → Metafields, define which metafields Pshly may read (material, size, colour) and write. Then review the category mappings so Shopify product types land on the right Pshly category — this drives the quality of collection and product suggestions.
   Done when: the key product attributes show up in a test text.
7. Tune suggestion settings
   Set the maximum number of matching products per product (default 2, configurable from 1 to 10). For collection suggestions, set the minimum score and maximum number of suggestions — a higher minimum score yields fewer but more reliable matches.
   Done when: a test run returns suggestions you'd accept without editing.
8. Image settings
   Choose the aspect ratio for AI lifestyle images (1:1, 4:3 or 16:9) and match it to your Shopify theme — a 1:1 image in a landscape theme gets cropped. Also set the desired image style and background.
   Done when: a generated image displays correctly in your theme without cropping.
9. Set up exclusions
   Products that are temporarily offline (seasonal, sold out) don't need optimising. Tag them in Shopify with pshly-skip (the tag name is configurable under Settings → Shopify), or exclude them manually in Pshly via More actions → Exclude from optimisation. Excluded products disappear from the work list, bulk jobs and review modals.
   Done when: the 'Excluded only' filter shows exactly the products you wanted to skip.
10. Test run on 3 to 5 products
    Select a handful of representative products and generate content. Review the result in the review modal: title, SEO title, meta description, body text and handle. If something is structurally off, adjust the settings (steps 3 to 5) instead of editing the text by hand.
    Done when: you'd push all five texts to Shopify unchanged.
11. Start your first bulk run
    Go to Product enrichment, filter down to the products you want to handle (for example active only, excluding skipped items), select them and start bulk content generation. The job runs server-side, so you can close the tab. Track progress via the realtime progress bar and the job log.
    Done when: the progress bar reaches 100% and the job log shows no errors.
12. Review and push to Shopify
    Open the bulk review modal, walk through the results and tick what may go live. Check titles, meta descriptions and changed URL handles in particular. Then push to Shopify in bulk; when setting products to Active, Pshly asks for an explicit confirmation.
    Done when: the products show status 'Pushed' in Pshly and the texts are live in Shopify.
13. Next: monitor and expand
    Connect Google Search Console for real search data, run the sitemap check, measure your AI visibility and keep an eye on credits and tier limits. Then schedule recurring runs for new products and collection texts.
    Done when: GSC is connected and your first sitemap check is green.

Tip: don't skip steps 3 to 9. Every minute spent on settings saves dozens of manual corrections in the review modal.

To use Pshly.ai you need an account. Go to pshly.ai and click "Sign up free".

• Enter your name, email address and a password (min. 6 characters).
• You'll receive a confirmation email — click the link to activate your account.
• After activation you can log in and access your dashboard.

After creating your account, the next step is connecting your Shopify store.

1. Go to your dashboard and click "Connect Shopify".
2. Follow the setup wizard to create a Custom App in your Shopify admin.
3. Copy the Access Token and your shop domain.
4. Paste them in Pshly.ai and click "Connect".

After a successful connection, your products and collections are synced automatically.

Your dashboard is the starting point of Pshly.ai with tabs for:

• Home — Store overview, onboarding checklist and quick actions.
• AI Visibility — How well your store is found by AI models.
• SEO Analysis — SEO scores and improvements per product/collection.
• Products — All imported products with generation and push status.
• Collections — All collections with content status.
• Alt Tags — Manage and generate alt texts for product images.
• Blog — Generate and manage blog posts.
• Sitemap — Health check for your sitemap.
• Settings — Prompts, language, metafields and more.

Ready to generate your first AI content?

1. Go to the Products tab.
2. Click on a product to open it.
3. Click "Generate" — the AI analyzes your product and writes an optimized description.
4. Review the result, edit if needed and click "Approve".

You can also generate multiple products at once using bulk actions.

The Shopify installation guide helps you connect your store step by step. Two methods are available:

• Method 1: Custom App via Shopify Admin — Standard 7-step method.
• Method 2: Via Shopify Dev Dashboard — Alternative if the 'Create an app' button is unavailable.

Both methods include screenshots and copy-paste fields. Use app name "Pshly.ai" and App URL https://pshly.ai.

The fastest route to an optimised shop:

1. Import your products and collections from Shopify.
2. Fill in your company info and writing style in Settings — this drives content quality.
3. Exclude products you don't want to optimise with the pshly-skip tag.
4. Run a bulk content generation on a small selection (e.g. 10 products) and review the result.
5. Happy? Run the full catalogue, review and push in bulk to Shopify.
6. Continue with alt tags, collection suggestions, matching products and lifestyle images.