Frequently Asked Questions
Answers to common questions about PeerScripts.
Frequently Asked Questions
Answers to common questions about PeerScripts.
General Questions
What is PeerScripts?
PeerScripts is an AI-powered Shopify embedded app for theme development and store management. It provides automated analysis, monitoring, and optimization tools to help merchants run better online stores.
How does PeerScripts work?
PeerScripts connects to your Shopify store via OAuth and analyzes your theme code, products, orders, and other data. It uses AI to detect issues, explain store behavior, and suggest improvements. All processing happens securely in the cloud.
Is PeerScripts safe to use?
Yes. PeerScripts:
- Uses OAuth for secure authentication
- Only requests necessary permissions
- Isolates data between stores
- Never stores sensitive payment data
- Follows Shopify's security guidelines
Does PeerScripts slow down my store?
No. PeerScripts runs separately from your storefront and doesn't add any code to your customer-facing pages. Analysis happens in the background and doesn't affect store performance.
What Shopify plans work with PeerScripts?
PeerScripts works with all Shopify plans, from Basic to Plus.
Features & Capabilities
What can PeerScripts analyze?
PeerScripts analyzes:
- Theme code: Performance, security, best practices
- SEO & content: Meta tags, accessibility, spelling
- Performance: Core Web Vitals, load times
- Catalog: Pricing, inventory, fulfillment
- Discounts: Code health, usage patterns
- Store operations: Orders, metrics, anomalies
- Installed apps: Permissions, activity, risks
Does PeerScripts modify my store?
PeerScripts is primarily read-only. It only modifies your store when you explicitly:
- Edit theme files in the Code Editor
- Execute bulk actions in the Action Center
- Make changes through approved workflows
Can PeerScripts fix issues automatically?
PeerScripts can generate fixes, but you always review and approve them before execution. The Action Center provides preview functionality so you see exactly what will change.
Does PeerScripts work with custom themes?
Yes. PeerScripts works with any Shopify theme, including:
- Free Shopify themes (Dawn, Craft, etc.)
- Paid themes from the Theme Store
- Custom-built themes
- Modified versions of any theme
Can PeerScripts help with headless stores?
PeerScripts focuses on standard Shopify themes. For headless implementations, the store health, catalog, and discount features still work, but theme analysis is limited to your Liquid templates.
AI Features
What AI does PeerScripts use?
PeerScripts uses OpenAI's GPT-4 models for:
- Code analysis and suggestions
- Explanation generation
- Change impact assessment
- Smart recommendations
Are my questions stored?
Query history is stored for your convenience and to improve suggestions. You can view and delete your history in settings.
How accurate is the AI?
AI features provide helpful suggestions but should always be reviewed. For code changes, always test before deploying. For explanations, verify against your actual data.
Can I choose which AI model to use?
Yes. In Settings, you can select from:
- GPT-4o (recommended)
- GPT-4o Mini (faster)
- GPT-4 Turbo (most detailed)
Data & Privacy
What data does PeerScripts access?
PeerScripts accesses:
- Theme files and code
- Product information
- Order data (for metrics, not payment info)
- Discount codes
- Installed app list
PeerScripts does NOT access:
- Customer payment information
- Credit card details
- Personal customer data beyond what's in orders
Where is my data stored?
Data is stored in secure Supabase infrastructure. Each store's data is isolated and cannot be accessed by other stores.
Can I export my data?
Yes. You can export:
- Scan reports
- Issue lists
- Tickets
- Metrics data
Go to Settings > Data to export.
What happens if I uninstall?
When you uninstall:
- Access is immediately revoked
- Your data is retained for 30 days (in case you reinstall)
- After 30 days, data is permanently deleted
Is my data shared with anyone?
No. Your data is:
- Never sold to third parties
- Never used for advertising
- Only used to provide PeerScripts services
- Processed by OpenAI for AI features (see their privacy policy)
Billing & Plans
How much does PeerScripts cost?
Contact us for current pricing information. We offer plans for stores of all sizes.
Is there a free trial?
Check the Shopify App Store listing for current trial availability.
Can I change plans?
Yes. You can upgrade or downgrade your plan at any time in Settings > Billing.
What payment methods are accepted?
Billing goes through Shopify's billing system, using whatever payment method you have on file with Shopify.
Team & Permissions
How many team members can I add?
Team member limits depend on your plan. Check your plan details in Settings > Billing.
What permission levels are available?
| Level | Capabilities |
|---|---|
| Owner | Full access, billing |
| Admin | All features except billing |
| Editor | Create and edit, no delete |
| Viewer | Read-only access |
How do I add team members?
- Go to Settings > Team
- Click "Add Member"
- Enter their Shopify staff email
- Select permission level
- They'll receive an invitation
Can team members see each other's activity?
Yes. All team members can see:
- Who created/modified tickets
- Who executed actions
- Team workload in sprint planning
Integrations
Does PeerScripts integrate with other apps?
PeerScripts works alongside other Shopify apps. It monitors installed apps but doesn't directly integrate with them.
Is there an API?
Yes. See the API Reference for documentation.
Can I set up webhooks?
Yes. Configure outgoing webhooks in Settings to receive notifications about:
- Completed scans
- New issues detected
- Ticket status changes
- Attention items
Does PeerScripts work with Shopify Flow?
Not directly, but you can use webhooks to trigger Flow actions based on PeerScripts events.
Troubleshooting
Why isn't my scan completing?
See Troubleshooting > Scans for common scan issues.
Why am I seeing false positives?
Use the "Ignore" feature to mark false positives. They won't appear in future scans. If you see consistent false positives, please report them.
Why is my data outdated?
Click "Sync Now" to force a refresh. Large stores may have slight delays. Check the sync indicator for data freshness.
Why can't I access certain features?
Check:
- Your permission level
- Your plan includes the feature
- Required setup is complete (e.g., baseline period)
Best Practices
How often should I run scans?
| Scan Type | Recommended Frequency |
|---|---|
| Theme Intelligence | Weekly, or after changes |
| Quality Audits | Weekly |
| Lighthouse | Weekly for monitoring, after optimizations |
| Catalog Detection | Daily (automated) |
| Discount Sync | Daily (automated) |
What should I fix first?
Prioritize by:
- Critical security issues
- High-severity issues affecting customers
- Performance problems
- SEO and content issues
- Best practice violations
How do I reduce noise?
- Use "Ignore" for known false positives
- Adjust notification thresholds in Settings
- Focus on high-severity issues
- Set up filtered views
Getting Help
How do I contact support?
- Documentation: Search these docs
- FAQ: You're here!
- GitHub Issues: For bugs and feature requests
- Email: Contact your account representative
Where can I request features?
Submit feature requests on GitHub Issues. We review all suggestions and prioritize based on demand.
How do I report a bug?
File a GitHub Issue with:
- Steps to reproduce
- Expected vs actual behavior
- Screenshots if applicable
- Browser/OS information
Is there a community forum?
Check our GitHub repository for discussions and community resources.
Updates & Roadmap
How often is PeerScripts updated?
We release updates regularly with:
- Bug fixes and improvements
- New features
- Security updates
Where can I see what's new?
Check the release notes in the GitHub repository.
Can I request features?
Yes! Submit feature requests on GitHub Issues. We love hearing from users.
Is there a public roadmap?
Check our GitHub repository for roadmap information and planned features.
Didn't Find Your Answer?
If your question isn't answered here:
- Search the full documentation
- Check Troubleshooting
- Contact support with your question
We continuously update this FAQ based on user questions.