AI FINDER · SETUP & SUPPORT
Let’s get you
finding.
From installation to your first storefront search. Keep this guide open alongside your Shopify admin.
GETTING STARTED
Five steps.
Your own store.
You’ll need access to your Shopify store as its owner and an appropriate Skulk organisation. Your theme must support app blocks.
Install on Shopify- 01
Install through Shopify
Open the App Store listing, choose your store and review the requested permissions. Open Skulk AI Finder from your Shopify admin to continue setup.
- 02
Connect your Skulk organisation
As the store owner, choose Create secure connection link, then Continue in Skulk. Sign in or create the appropriate Skulk account, return to the connection screen and choose Connect. Signing in alone does not link the store. Return to Shopify and choose I’ve connected — check status.
- 03
Connect your catalogue and review your plan
Under Storefront search, connect your public Shopify catalogue and review the markets you serve. If you are new to Skulk, choose the Finder plan in Shopify and approve its charges there. If you already pay Skulk, confirm that in the app first. Check your verified allowance and spending controls before enabling AI. The optional private metadata import is not required for shopper search.
- 04
Add Finder to your theme
Choose Add Finder to the homepage. In Shopify’s Theme Editor, confirm the Product finder block is in the Apps section. If you already added it, use Open editor if already added to avoid a duplicate. Adjust the heading and introduction, then enable AI and photo search once your connection and allowance are ready.
- 05
Preview, test and publish
Save the theme and test on desktop and mobile. Try a text search, a reference photo, a search with no good match and the ordinary search route. Open suggestions and check they lead to the correct Shopify products. Keep your current theme published until you are happy with the experience.
IF SOMETHING GETS STUCK
A few things
to check.
Connection, catalogue, allowance, theme. Work through those in order.
I signed in, but Shopify still says connect.
Signing in does not complete the connection. Return to the Skulk connection screen and choose Connect, then return to Shopify and choose I’ve connected — check status. Connection links expire after ten minutes; create a fresh one if needed. The relevant store and organisation owners must approve.
AI or photo search is not enabled.
Check that the Skulk connection is complete, Storefront search is configured and your plan and credits are verified in the app. Then check the AI and photo search settings in the Product finder theme block and save. Catalogue search can remain available while AI is disabled.
I cannot see the Finder block.
Open the theme you intend to use, check that it supports app blocks and look in the homepage Apps section. Use the app’s Add Finder to the homepage link to start. If the block is already present, open the editor instead of adding it twice. Save and preview the correct theme.
Results are missing or do not match.
Check Storefront search and the selected market in the app. Confirm the products are available to that storefront and market in Shopify. Try an ordinary product-name search first, then a broader description or a clearer reference photo. Photo discovery looks for a similar feel; it cannot guarantee an identical product.
THE DETAILS
Good to know.
Can I install AI Finder now?
Yes. Skulk AI Finder is available on the Shopify App Store. Choose Install on Shopify to open the listing, select your store and review permissions and pricing in Shopify. This website does not install the app or start a subscription.
Will it work with my current theme?
Finder adds an app block to a compatible Shopify theme. Your theme needs to support app blocks where you want to place it. You do not need Fable, a Store Studio project, Visualiser or Website Builder. Preview the block in your theme before publishing it.
Do I need an account with an external AI provider?
You connect your Shopify store to a Skulk organisation during setup. The Shopify store owner and the Skulk organisation owner approve that connection. Skulk manages the connection to the external AI provider, so you do not need a separate provider account or your own API key.
How do the price and AI credits work?
The Starter plan is US$19 every 30 days and includes 100 AI credits per billing period. A complete AI search can use up to 2 credits. You can review your allowance and spending controls in the app. There are no automatic top-ups or usage charges. Shopify shows the applicable price and terms before you approve a subscription.
Will a photo find the exact same product?
A reference photo helps Finder look for relevant products with a similar look or feel in your catalogue. It is a starting point for discovery, not a guarantee of an exact match. Shoppers can follow a suggestion to the Shopify product page to check its details.
What happens when AI is unavailable?
Finder keeps an ordinary search route available. If AI is unavailable, disabled or out of credits, searches fall back to clearly labelled Shopify catalogue results. Shopify remains the source for product details, prices, availability and checkout.
A HUMAN HAND
Still need help?
Tell us your store URL, the step you reached and the message you see. A screenshot helps. Please leave out passwords, API keys and customer details.
Email the Skulk team Back to AI Finder ↗