E-commerce & Shopify

OnixFeed integrates with Shopify and other e-commerce platforms to help you sell your books online.

Shopify Integration

There are two ways to get your books into Shopify:

Option 1: CSV Export (Recommended for Setup)

Export your books as a Shopify-compatible CSV file:

1. Go to Books
2. Select the books you want to export
3. Click Export and choose Shopify CSV
4. Review any validation warnings
5. Download the CSV file
6. In Shopify Admin: Go to Products → Import
7. Upload the CSV file

Data Mapping:

OnixFeed Field	Shopify Field
Title	Product Title
Description	Body (HTML)
Publisher	Vendor
ISBN-13	SKU and Barcode
Cover Image	Product Image
Price	Variant Price
Stock Quantity	Inventory Quantity

Requirements: Books must have title, ISBN-13, price, and publisher to be exported. Incomplete books will be flagged.

Option 2: Direct API Publish

Publish books directly to your Shopify store:

1. Go to Books
2. Select books to publish
3. Click Publish to Shopify
4. Enter your store details:
   • Store URL - e.g., your-store.myshopify.com
   • Access Token - Your Shopify Admin API token
5. Click Test Connection to verify
6. Click Publish

The system will show progress and report success/failure for each book.

Setting Up Shopify API Access:

1. In Shopify Admin, go to Settings → Apps and sales channels
2. Click Develop apps (you may need to enable this)
3. Create a new app
4. Under API credentials, configure Admin API scopes:
   • read_products
   • write_products
   • read_inventory
   • write_inventory
5. Install the app and copy the Admin API access token

Theme Management

Navigate to Themes in the sidebar to manage collections that can be deployed to Shopify.

Creating Collections

1. Go to Themes
2. Click Add Collection
3. Fill in the details:
   • Name - Collection name
   • Identifier - Unique identifier
   • Type - Collection type
   • Language - Language setting
4. Click Save

Deploying to Shopify

1. Select collections to deploy
2. Click Deploy
3. Enter your Shopify credentials
4. Test the connection
5. Optionally choose a navigation menu placement
6. Start deployment

Collections are created as "smart collections" in Shopify with auto-tagging rules. The Shopify collection ID is saved back to OnixFeed for tracking.

Store Collections (WooCommerce)

Navigate to Store Collections (under WooCommerce in the sidebar) to manage book collections for any e-commerce platform.

Creating a Store Collection

1. Go to Store Collections
2. Click Create Collection
3. Enter a name for your collection
4. Click Save

Adding Books to a Collection

1. Click Manage Books on your collection
2. Search for books to add
3. Click Add for each book
4. Or use bulk actions from the Books page

Exporting Collection Data

Generate CSV exports for your e-commerce platform:

1. Click Generate and choose what to export:
   • Books - Full product data
   • Contributors - Author information
   • Reviews - Book reviews
   • Publishers - Publisher details
2. Confirm the export
3. Click View CSV to download files

Note: Only Published books are included in exports. Draft books are excluded.

CSV Export Options

Export Type	Use For	Contains
Shopify CSV	Shopify product import	Product data in Shopify format
Books CSV	Any platform	Full book metadata
Contributors CSV	Author pages	Author and contributor data
Reviews CSV	Review display	Review content
Publishers CSV	Publisher pages	Publisher information

Best Practices

Initial Setup

1. Clean your book data first (titles, ISBNs, prices)
2. Add cover images to all books
3. Export a small test batch first
4. Review the CSV before importing to Shopify
5. Import the full catalog once tested

Ongoing Updates

1. Use direct API publish for individual book updates
2. Re-export CSV for bulk changes
3. Keep stock levels synced between systems
4. Deploy collections when your catalog structure changes

Data Quality

For best results in your online store:

• Complete all required fields - Title, ISBN, price, publisher
• Add descriptions - Good descriptions improve sales
• Include cover images - Products with images sell better
• Set accurate stock - Avoid overselling
• Use proper categories - Helps customers find books

Troubleshooting

Export validation errors:

• Check that books have title, ISBN-13, price, and publisher
• Fix incomplete books before exporting

Shopify connection fails:

• Verify your store URL format (store-name.myshopify.com)
• Check that your access token is correct and has required permissions
• Ensure your app is installed in Shopify

Products not appearing in Shopify:

• Check the import was successful in Shopify Admin
• Verify products aren't set to "Draft" in Shopify
• Look for import errors in Shopify's import results

Duplicate products:

• Shopify matches products by handle or SKU
• Use ISBN as SKU to prevent duplicates
• Consider deleting existing products before re-importing

---

Previous: Reviews & Content | Next: Account & Settings