Frequently Asked Questions

What does SpecLeaf do?

SpecLeaf turns authorized Shopify product information into polished previews, product sheets, catalogs and PDF or ZIP exports. Merchants can save brand kits and document setups, choose products and formats, review a preview, and securely download the finished edition.

What Shopify access does it request?

SpecLeaf requests only read_products. That lets it read the product, variant, collection, image, price and supported metafield information selected for catalog production. It does not request customer, order, payment, inventory or theme scopes.

SpecLeaf does not write back to products or themes. Shopify session credentials are used on the server to authenticate authorized requests and are not shown in the app.

Which formats and product fields are supported?

The available maker screens identify the current document formats, product limits and layout options. Common catalog fields include titles, descriptions, vendor, product type, variants, prices, SKUs, barcodes, images, options, collections and selected simple metafields.

Text, numbers, dates, booleans, URLs, dimensions, weights, volumes, colors and simple lists can be supported. References, files, metaobjects and complex JSON are intentionally excluded in the current release. The preview is the authoritative place to confirm how a field will render.

Why is content missing or different in a preview?

Confirm the product data is published and current in Shopify, the selected variant has the expected price or SKU, images can be read, and the metafield uses a supported type. Long text, unusually large images and page-size constraints may cause intentional truncation or pagination changes.

Always review the preview and final file before distribution. SpecLeaf does not independently verify prices, claims, measurements or regulatory language.

How long are generated files available?

Download access expires after 60 minutes in this deployment. The underlying PDF or ZIP is then eligible for scheduled deletion. Download the file promptly and keep your own copy; SpecLeaf is not an archival service.

An expired file cannot be restored through its old link. Generate a new edition from the current product and brand data instead.

When does an export count against quota?

A paid export counts only after its secure download completes successfully. A preview, a failed generation, or an undownloaded file that expires does not consume the committed export in the normal workflow. Current product and export limits appear on the plan and maker screens and do not roll over unless expressly stated.

How do plans and billing work?

Shopify manages SpecLeaf subscription approval and billing. The app and Shopify approval screen show the price, billing interval, quota and any trial before a merchant accepts. Shopify applies approved charges to the merchant's Shopify invoice; SpecLeaf does not collect payment-card details.

Plan changes, cancellation, proration and charge timing follow the confirmation shown by Shopify. See the Terms of Service or contact [email protected] with the store domain and charge date.

What are Brand Kits and Saved Setups?

Brand Kits store a merchant's colors, logo and optional business details for reuse. Saved Setups store document and layout choices. They remain associated with the shop until archived, replaced, deleted or removed during uninstallation. Do not place unnecessary customer or sensitive personal information in these fields.

How do I delete SpecLeaf data?

Archive or replace individual Brand Kits and Saved Setups within the app. To end all processing for a store, uninstall SpecLeaf through Shopify. Uninstallation removes active sessions and primary tenant data and queues stored logos and generated files for deletion.

Shopify's mandatory shop/redact request completes final shop redaction. Customers should submit privacy requests to the merchant first. The Data Deletion guideexplains the complete workflow.

What should I do when an export fails?

Refresh the page, confirm Shopify is available, retry a small preview and verify that selected products have valid data. Do not repeatedly submit a large job if the same error continues.

Then email [email protected] with the shop domain, time and time zone, visible job identifier, format and steps. Never send passwords, access tokens or customer data.