Shopify Installation¶

Step-by-step guide to installing the Functional AI app on your Shopify store.

What You'll Need

Active Shopify store (any plan)
Store owner or admin access
Functional AI account with at least one configured assistant

Prerequisites¶

Before you begin:

Active Shopify store (any plan)
Store owner or admin access
Functional AI account
At least one configured assistant

Installation Steps¶

Step 1: Access Shopify App Store¶

Log in to your Shopify admin
Go to Apps in the sidebar
Click Shopify App Store
Search for "Functional AI"

Or go directly to our app listing (link in your Functional AI dashboard).

Step 2: Add App¶

Click on the Functional AI app
Click Add app or Install
Review the permissions requested

Step 3: Authorize Permissions¶

You'll be asked to authorize specific permissions. Understanding what each permission does helps you make an informed decision.

Required Permissions¶

Permission	Purpose	What We Access	What We Don't Access
Read store information	Display chatbot properly	Store name, domain, timezone	Financial data, customer lists
Read products	Enable product recommendations	Product titles, descriptions, prices	Sales data, inventory counts
Access themes	Install the widget via app embeds	Theme customization settings	Theme code, custom modifications

Why these permissions and security details

Why These Permissions: - Read store information: Identify your store and configure the widget correctly - Read products: Answer product-related questions accurately - Access themes: Required for Shopify's App Embeds system

Security: - Minimum necessary permissions only - Tokens encrypted using Fernet encryption - No data sharing with third parties - Revokable anytime by uninstalling

Click Install app to authorize these permissions.

Step 4: Connect Account¶

After installation:

You'll be redirected to Functional AI
Log in with your Functional AI account (or create one)
Your Shopify store is now linked

Step 5: Initial Configuration¶

The app opens to the preferences page:

Select which assistant to use
Toggle the widget visibility ON
Save your settings

See Configuration for detailed options.

Verifying Installation¶

Check in Shopify Admin¶

Go to Apps in your Shopify admin
Verify Functional AI appears in installed apps
Click to open the app settings

Check on Your Store¶

Visit your store's frontend
Look for the chat widget (usually bottom-right)
Click to open and test

May Take a Moment

The widget may take a few minutes to appear after enabling. If it doesn't appear, try refreshing your store page.

Post-Installation Checklist¶

After installation, complete these steps:

Troubleshooting¶

App won't install¶

Possible causes: - Insufficient permissions - Plan limitations - Browser issues

Solutions: - Log in as store owner - Clear browser cache - Try a different browser

Can't see app after install¶

Go to Apps in Shopify admin
Look for Functional AI in the list
If not visible, try reinstalling

Authorization fails¶

Check you're logged into the correct Shopify store
Verify your Functional AI account is active
Try logging out and back in

Verify widget is enabled in settings
Check if assistant is selected
Test in an incognito window
See Configuration troubleshooting

Updating the App¶

The app updates automatically. To ensure you have the latest version:

Go to Apps in Shopify admin
Check for update notifications
Updates apply automatically when available

Uninstalling¶

If you need to remove the app:

Go to Apps in Shopify admin
Click on Functional AI
Scroll to bottom and click Uninstall
Confirm the uninstallation

Data Retention

Uninstalling removes the widget from your store. Your conversation history is retained in your Functional AI account.

Support¶

If you encounter issues:

Check this documentation
Review the Configuration guide
Contact Functional AI support