Help Center
Find answers to common questions about NativeProof. Search our FAQ or browse by category.
Installation & Setup
Installing NativeProof is simple and takes just a few minutes:
- Visit the Shopify App Store and search for "NativeProof" or use the direct install link.
- Click "Add app" and authorize the required permissions (read products, read orders, read/write metaobjects).
- Complete the setup wizard which will configure your store and enable the theme app extension.
- Go to Online Store > Themes > Customize and add NativeProof blocks to your product pages.
The entire process typically takes less than 5 minutes. Our theme app extension automatically integrates with your theme without requiring any code changes.
If your reviews are not displaying on your storefront, check these common causes:
- Theme App Extension not enabled: Go to Online Store > Themes > Customize, then ensure NativeProof blocks are added to your product template.
- Reviews not synced: Visit the NativeProof dashboard and check if your reviews have the "Synced" status. Click "Sync to Storefront" if needed.
- Reviews not approved: Only approved reviews display on the storefront. Check the review status in your dashboard.
- Product handle mismatch: Reviews are linked by product handle. If you changed the product URL, you may need to re-link reviews.
- Cache issues: Try clearing your browser cache or viewing the page in incognito mode.
If issues persist, contact our support team with your store URL and we'll help troubleshoot.
NativeProof uses Shopify's Theme App Extension system for seamless integration:
- Go to Online Store > Themes in your Shopify admin.
- Click "Customize" on your active theme.
- Navigate to a Product page template.
- Click "Add block" or "Add section".
- Look for "NativeProof" in the Apps section.
- Select the widget you want: Reviews Widget, Star Rating Badge, Review Form, etc.
- Configure the widget settings and click "Save".
You can add multiple widgets to different locations on your page. All widgets render server-side for zero layout shift.
Importing Reviews
Migrating from Judge.me is straightforward with our automatic import:
- Export from Judge.me: In Judge.me, go to Settings > Export and download your reviews as a CSV file.
- Open NativeProof: Navigate to Settings > Import Reviews in your NativeProof dashboard.
- Select "Judge.me" as the source platform. Our system will automatically detect the correct column mapping.
- Upload your CSV file and preview the import. You'll see which reviews will be imported.
- Click "Import" to begin. Large imports process in the background.
Photos and videos from Judge.me are automatically imported. Verified buyer status is preserved. The import typically completes within a few minutes for most stores.
NativeProof supports flexible CSV imports with automatic column detection. For manual imports, use these columns:
| Column | Required | Description |
|---|---|---|
| product_handle | Yes | Shopify product URL handle |
| rating | Yes | 1-5 star rating |
| title | No | Review title/headline |
| body | Yes | Review text content |
| author | Yes | Reviewer name |
| No | Reviewer email (for verified buyer check) | |
| created_at | No | Review date (ISO 8601 format) |
| photo_urls | No | Comma-separated image URLs |
| video_url | No | Video URL |
Download our sample CSV template for the correct format.
Yes! NativeProof fully supports importing reviews with media:
- Photos: Include image URLs in the
photo_urlscolumn (comma-separated for multiple images). We'll download and store them securely. - Videos: Include video URLs in the
video_urlcolumn. Videos are uploaded to Cloudflare Stream for optimal delivery.
Supported formats:
- Images: JPG, PNG, WebP, GIF (max 10MB each)
- Videos: MP4, MOV, WebM (max 500MB, 5 minutes)
When importing from Judge.me, Yotpo, or Loox, media URLs are automatically detected and imported. For large media imports, processing happens in the background to prevent timeouts.
Displaying Reviews
NativeProof widgets are fully customizable through the theme editor:
- Go to Online Store > Themes > Customize.
- Select the page with your NativeProof widget.
- Click on the NativeProof block to see settings.
Available customization options:
- Colors: Star color, text color, background color, accent colors
- Typography: Font sizes, font weights (inherits from theme by default)
- Layout: Reviews per page, grid columns, spacing
- Features: Show/hide photos, verified badges, dates, ratings breakdown
- Sorting: Default sort order (newest, oldest, highest rated)
All widget settings are configured directly in the Shopify Theme Editor. Click on any NativeProof block to access its customization options.
Absolutely! NativeProof provides several widgets perfect for homepage display:
- Cards Carousel: Showcase top reviews in a swipeable carousel format.
- Testimonial Carousel: Display quotes from happy customers with a clean, minimalist design.
- Reviews Carousel: Rotating display of product reviews with star ratings.
- UGC Media Grid: Display customer photos and videos in an Instagram-style grid.
To add to your homepage:
- Go to Online Store > Themes > Customize.
- Select your homepage template.
- Add a section and choose the NativeProof widget you want.
- Configure which reviews to show (all products, specific collection, featured reviews).
All homepage widgets render server-side with zero layout shift.
NativeProof includes 15+ display widgets, all server-side rendered:
Product Page Widgets:
- Product Reviews Widget - Full review list with filtering and sorting
- Review Form Block - Collect reviews from customers
- Star Rating Badge - Compact rating display for product cards
- Questions & Answers - Customer Q&A section
Carousel Widgets:
- Cards Carousel - Mobile-friendly review cards
- Video Carousel - Video reviews with thumbnails
- Testimonial Carousel - Customer quotes
- Reviews Carousel - Rotating reviews display
Other Widgets:
- Trust Badges & Medals - Credibility indicators
- UGC Media Grid - Photo/video gallery
- All Reviews Page - Dedicated reviews page
- Pop-up Reviews - Overlay display
- Floating Sidebar - Always-visible reviews panel
Managing Reviews
NativeProof provides flexible moderation options:
Manual Moderation:
- Go to your NativeProof Dashboard > Reviews.
- Filter by status to see "Pending" reviews.
- Click on a review to expand details.
- Click "Approve" or "Reject".
Bulk Actions:
- Select multiple reviews using checkboxes.
- Use the bulk action dropdown to approve, reject, or delete.
Approved reviews sync to your storefront automatically within seconds via Shopify Metaobjects.
NativeProof uses a manual moderation workflow for quality control:
- New reviews appear as "Pending" in your dashboard.
- Review each submission to ensure quality and relevance.
- Click "Approve" to publish to storefront or "Reject" to decline.
- Approved reviews sync automatically to Shopify Metaobjects within seconds.
Benefits of Manual Moderation:
- Full control over what appears on your storefront.
- Prevent spam, inappropriate content, or competitor reviews.
- Ensure reviews are relevant to your products.
- Maintain brand consistency and customer trust.
Use bulk actions to approve or reject multiple reviews at once for efficient moderation.
NativeProof automatically verifies if reviewers purchased the product:
How It Works:
- When a review is submitted, we securely hash the customer's email.
- We compare this hash against your order history (also hashed).
- If a match is found for that product, the "Verified Buyer" badge is applied.
Privacy & Security:
- We never store plaintext customer emails.
- Email addresses are hashed with SHA-256 + per-shop salt.
- Order data is accessed only through Shopify's secure API.
- Compliant with GDPR and privacy regulations.
Verification Sources:
- Shopify orders (automatic matching via order webhooks)
- Imported reviews with email matching
Verified buyer badges significantly increase customer trust and conversion rates.
Google Shopping
NativeProof generates a Google Product Review XML feed that meets all Google Merchant Center requirements:
- Go to NativeProof Dashboard > Settings > Google Shopping.
- Click "Enable Feed" to activate XML generation.
- Copy your unique Feed URL (e.g., https://yourstore.myshopify.com/apps/nativeproof/feed.xml).
- In Google Merchant Center, go to Growth > Product Reviews.
- Click "Add product reviews feed" and paste your Feed URL.
- Set the fetch frequency (we recommend daily).
Requirements for Google Product Reviews:
- Minimum 50 reviews total across your products.
- Reviews must be in supported languages.
- Products must have valid GTINs or identifiers.
The feed updates automatically when new reviews are approved.
The NativeProof feed follows Google's Product Review Feed Specification:
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns:g="http://base.google.com/ns/1.0">
<version>2.3</version>
<publisher>
<name>Your Store Name</name>
</publisher>
<reviews>
<review>
<review_id>12345</review_id>
<reviewer>
<name>John D.</name>
</reviewer>
<review_timestamp>2024-01-15T10:30:00Z</review_timestamp>
<content>Great product...</content>
<review_url>...</review_url>
<ratings>
<overall min="1" max="5">5</overall>
</ratings>
<products>
<product>
<product_ids>
<gtins><gtin>1234567890123</gtin></gtins>
</product_ids>
<product_name>Product Name</product_name>
<product_url>...</product_url>
</product>
</products>
</review>
</reviews>
</feed>
Feed Features:
- Automatic GTIN/SKU detection from your products
- Imported reviews marked with
<country>ZZ</country>per Google guidelines - Review media (photos) included when available
- Proper timestamp formatting in ISO 8601
Billing & Account
NativeProof billing is handled entirely through Shopify:
Pricing:
- $5.00 USD/month - Full access to all features
- Unlimited reviews and all widgets included
- Google Shopping XML feed included
- Video reviews via Cloudflare Stream included
How Billing Works:
- All charges appear on your regular Shopify invoice.
- We use Shopify's secure billing API - no separate credit card needed.
- View your subscription status in the NativeProof dashboard.
Free Trial:
- Start with a 30-day free trial - no charge during this period.
- Full access to all features during trial.
- Cancel anytime before trial ends with no charge.
Yes, you can cancel your NativeProof subscription at any time:
- Go to NativeProof Dashboard > Settings > Billing.
- Click "Manage Subscription".
- Select "Cancel Plan" or downgrade to Free.
What happens when you cancel:
- You retain access until the end of your billing period.
- Your reviews remain in our system (not deleted).
- Widgets continue showing existing reviews on Free plan limits.
- You can reactivate anytime with no data loss.
Refund Policy:
- Shopify handles all refunds per their merchant agreement.
- Contact us within 7 days if you're unsatisfied for a pro-rated refund.
We make it easy to try NativeProof risk-free with our 14-day trial.
Your review data is preserved even if you uninstall NativeProof:
When You Uninstall:
- Widgets are automatically removed from your theme (clean uninstall).
- Your review data is retained in our system for 30 days.
- Metaobject data in Shopify is preserved.
- No residual code is left in your theme.
Reinstalling:
- If you reinstall within 30 days, all your data is restored automatically.
- Simply add the widgets back to your theme.
- Reviews, settings, and history are preserved.
Permanent Deletion:
- After 30 days, data is permanently deleted per our privacy policy.
- Contact support if you need data exported before deletion.
- We can provide a CSV export of all your reviews.
We recommend exporting your reviews before uninstalling if you want a permanent backup.
Troubleshooting
NativeProof is designed for zero layout shift (CLS = 0.00). If you're experiencing CLS issues:
Common Causes & Fixes:
- JavaScript blocking render:
- Check if other apps are injecting scripts that delay rendering.
- Disable other review/widget apps temporarily to test.
- Theme conflicts:
- Ensure you're using the theme app extension blocks, not custom code.
- Check for CSS that might override our styling.
- Images loading without dimensions:
- NativeProof pre-allocates space for review photos automatically.
- Check if third-party apps or theme customizations override our CSS.
- Async loading enabled:
- NativeProof should NOT use async loading - it's server-rendered.
- Contact support if you see async behavior.
Testing CLS:
- Use Google PageSpeed Insights to measure CLS.
- Use Chrome DevTools > Performance panel for detailed analysis.
Import failures usually have fixable causes. Here's how to troubleshoot:
Check the Error Message:
- "Invalid product handle" - The product_handle column contains handles that don't exist in your store. Verify handles match exactly.
- "Missing required fields" - Ensure product_handle, rating, body, and author columns are present and filled.
- "Invalid rating" - Ratings must be numbers 1-5. Check for text values or empty cells.
- "File too large" - Split your CSV into smaller batches (under 10MB each).
CSV Format Issues:
- Save as UTF-8 encoded CSV (not Excel format).
- Use commas as delimiters (not semicolons or tabs).
- Ensure text fields with commas are wrapped in quotes.
- Remove any special characters or emojis that may cause encoding issues.
Still Having Issues?
- Download and use our CSV template.
- Try importing 5-10 reviews first as a test.
- Contact support with your CSV file and error message.
Video playback issues can have several causes:
1. Check Video Status in Dashboard:
- Go to the review with the video.
- Check the video status: "Processing", "Ready", or "Error".
- "Processing" - Wait a few minutes for encoding to complete.
- "Error" - The video format may be unsupported.
2. Supported Video Formats:
- MP4 (H.264 codec) - Recommended
- MOV (from iPhone)
- WebM
- Maximum file size: 500MB
- Maximum duration: 5 minutes
3. Browser/Device Issues:
- Ensure the customer's browser supports HTML5 video.
- Some ad blockers may interfere with video loading.
- Try viewing in incognito mode.
4. Cloudflare Stream Issues:
- Videos are served via Cloudflare Stream CDN.
- Check Cloudflare Status for outages.
- Contact support if specific videos consistently fail.
Re-upload Option:
- For imported videos that fail, you can re-upload directly.
- Edit the review and use "Replace Video" option.
Quick Links
Documentation
Complete technical documentation including API reference, widget configuration, and integration guides.
Features Overview
Explore all NativeProof features including widgets, Google Shopping feed, and verified buyer detection.
Screenshots
See NativeProof in action with screenshots of the admin dashboard and storefront widgets.
Install NativeProof
Get started with NativeProof on your Shopify store. Free plan available with no credit card required.
Still Need Help?
Our support team is here to help. Choose the option that works best for you.