Third-Party Integrations
Ark Naturals uses a small set of focused integrations. Compared with the Antelope Pets umbrella store, there's no Algolia, Swym, Attentive, Wholesale Gorilla, or Accessibly — Ark relies on native Shopify search and a leaner stack.
| App | Category | Status | Where it's wired |
|---|---|---|---|
| Junip Reviews | Reviews | Active | PDP & PLP review badges, Junip review app block on every product template, store key block |
External review sync (reviews.* metafields) | Reviews data | Active | Off-site (Amazon / Chewy) totals blended into every star rating. See below |
| Klaviyo | Email & SMS | Active | Footer signup, popups, countdown timer |
| ReCharge | Subscriptions | Active | PDP subscribe option, account portal |
| Gorgias | Customer support | Active (link only) | Footer "Contact Us" link, account help |
| Pinpoint Store Locator | Store locator (our own app) | Active | App block on page.custom-store-locator.json. See Store Locator |
Junip — Product Reviews
Used for collecting and displaying product reviews across the site.
Where it shows up
| Location | Snippet / block | What it renders |
|---|---|---|
| Product detail page (under the title) | junip-product-summary.liquid | Stars + full count ("2,342 reviews"). Clicking scrolls to the review list. With no reviews: a "Write a review" link. |
| Collection / search cards | junip-product-plp.liquid | Average + stars + short count, e.g. 4.4 ★★★★☆ (2.3k). With no reviews: a "Write a review" link. |
| PLP header | reviews-aggregate-badge.liquid | Collection-wide stars + "26,860 reviews across all platforms". See Collection Pages → Reviews badge. |
| Full review list (PDP) | Junip app block Product reviews (shopify://apps/junip/blocks/junip-product-review/…) in an apps section | The full Junip review widget. On every product template. |
| Full review list (PDP), figures | section-blended-review-widget.liquid → blended-review-widget.liquid + blended-review-summary.liquid | Rewrites the average, star fill and count inside the Junip widget with the blended figures. See below. |
| Legacy wrapper | section-product-reviews.liquid → junip-product-review.liquid | Headline + Junip mount point. Not used by any product template. |
Metafields it reads
| Metafield | Type | Purpose |
|---|---|---|
product.metafields.junip.rating_average | Number | Average star rating |
product.metafields.junip.rating_count | Number | Total number of reviews |
shop.metafields.junip.store_key | String | Junip store identifier |
shop.metafields.junip.onsite_enabled | Boolean | Master switch for the onsite widget |
shop.metafields.junip.review_count_enabled | Boolean | Whether to show the review-count badge |
Where Junip is configured
The Junip app itself (review request emails, moderation, customization) is configured in the Junip dashboard, not the theme. The theme just renders whatever Junip publishes via metafields and embed.
App embed block
In Customize → App embeds there is a junip-store-key block with enablePreviewMode: true. This sends review widgets to a preview environment — turn it off before going live with any review-related change.
Blended (cross-platform) review figures
Junip only knows the reviews collected on arknaturals.com. An external daily sync writes cross-platform totals into a separate reviews metafield namespace. The theme shows those totals whenever a product has off-site reviews.
| Metafield | What it holds |
|---|---|
product.metafields.reviews.blended_rating | Average rating across all platforms (0–5) |
product.metafields.reviews.blended_count | Total review count across all platforms |
product.metafields.reviews.amazon_reviews | Amazon review count |
product.metafields.reviews.chewy_reviews | Chewy review count |
Which numbers are shown. This rule is the same on the PDP summary, the PLP cards, the PLP header badge and the review widget:
- A product "has off-site reviews" when
amazon_reviews > 0, orchewy_reviews > 0, orblended_countis larger than Junip'srating_count. - If it does, and
blended_ratingandblended_countare both above 0, the blended figures are used and the copy says "across all platforms". - Otherwise Junip's own
junip.rating_average/junip.rating_countare used, with no disclaimer.
Formatting is centralised so the same product never shows two different numbers:
| Helper | Rule | Example |
|---|---|---|
helper-review-rating.liquid | One decimal, truncated (not rounded), trailing .0 dropped. This matches what the Junip widget prints. | 4.59 → 4.5, 5.0 → 5 |
helper-review-count.liquid | full = thousands separator (PDP, widget). short = shortened above 1,000 (PLP cards). | 2,342 / 2.3k |
Stars fill proportionally: a 4.4 average fills 88% of the five-star row.
Inside the Junip review widget (the Blended Review Widget section, which is on every product template):
blended-review-widget.liquidwaits for Junip to render and then replaces the average, the star fill and the count with the blended figures. The count reads e.g. "2,342 Reviews across all platforms". The per-star distribution bars are hidden, because the sync doesn't provide per-star counts. This only runs for products that have off-site reviews.blended-review-summary.liquidcovers products with zero Junip reviews but blended figures. Junip then renders only its empty state, so the theme injects a rating summary built with Junip's own CSS classes above it. Junip's "Write a review" button stays.
The Blended Review Widget section has no visual output
It's a "script-only" section: add it once per product template, anywhere on the page. Don't add a second Junip review block to "make it show": that renders the review list twice.
The data comes from outside the theme
The reviews.* metafields are written by an external daily sync, not by Junip and not by the theme. If a number looks wrong, check the product's reviews metafields in Shopify Admin → Products → (product) → Metafields first.
Klaviyo — Email & SMS
Used for newsletter signups, popups, abandoned-cart and SMS flows.
Default list ID
VSYjCb — set in Theme settings → Klaviyo Email List → Klaviyo ID. Used by:
- The footer newsletter form (
layout-footer.liquid) - The countdown timer notify form (
section-timer.liquid) - Any other custom signup form that reads
settings.klaviyo_id
Onsite embed
In Customize → App embeds there is a klaviyo-onsite-embed block. This injects Klaviyo's universal script so popups, forms and SMS opt-in widgets built in the Klaviyo dashboard appear on the storefront automatically.
Add a new popup or form
Build it in Klaviyo → Signup forms and target this domain. No code change needed in the theme — the embed picks it up automatically.
NPM dependency
The theme bundles klaviyo-subscribe@1.0.0 for the direct AJAX subscription call from the footer form (manage.kmail-lists.com/ajax/subscriptions/subscribe).
ReCharge — Subscribe & Save
Powers the Subscribe & Save option on every product detail page.
How it appears on the PDP
Every product page renders a purchase-mode toggle:
- Subscribe & Save (with the benefits spoiler underneath)
- One-Time Purchase
When Subscribe & Save is selected, a hidden selling_plan input is sent with the add-to-cart payload (block-product-submit.liquid / pf-subscription-selector.liquid).
Data it reads
| Source | Purpose |
|---|---|
product.selling_plan_groups | The subscription plans attached to a product (frequency, name) |
product.selling_plan_allocations | Discounted prices per plan |
Snippet json-product-prices.liquid | Generates the JSON consumed by the Vue product form |
Customer subscription portal
Customers manage their subscriptions outside the theme, at:
https://arknaturals.com/tools/recurring/get-subscription-accessThe link is wired into main-page-subscription-login.liquid (used by the page.account-login.json template). The portal itself is hosted by ReCharge — content managers don't edit it from the theme.
Plans are managed in ReCharge
Subscription frequencies and discount percentages are configured in the ReCharge dashboard, not in Shopify. Edits to plans there propagate to the storefront automatically — no theme change required.
Gorgias — Customer Support
Gorgias is the help-desk used by Alpine Pet Holdings across all brands. Ark links to it from:
- Footer → "Contact Us" link defaults to
https://antelopepets.gorgias.help/en-US/contact - Subscription/account login page → support contact callout
There is no Gorgias widget embedded in the theme — only outbound links. Live chat (if enabled) is injected by Shopify's app embeds, not by this theme directly.
Pinpoint Store Locator
The store locator at /pages/store-locator is the Store locator app block from Pinpoint Store Locator, our own Shopify app. Locations are managed in Shopify Admin → Apps → Pinpoint Store Locator, not in the theme.
- Theme side (template, block settings, "Other Brands" tiles): Store Locator
- The app itself (admin, CSV import, API): Pinpoint Store Locator
Every Find Store button on the PDP and PLP cards (shown when a product is sold out) links to /pages/store-locator.
Native Shopify features used (not third-party)
Ark relies on Shopify's built-in features for several things you might expect from an app:
| Feature | Where it lives |
|---|---|
| Site search | Native Shopify Search. The header search dropdown (Search Vue component) calls Shopify's Predictive Search API (/search/suggest.json) twice once the query is 4+ characters long: once for products, once for blog articles (up to 5 of each). "View all" goes to /search?q=…, and that results page lists Products and Articles separately. No Algolia. |
| Cart | Custom Vue-powered drawer + native /cart endpoint |
| Customer accounts | Shopify new customer accounts — login, dashboard, order history are all hosted by Shopify; the theme only renders the custom Subscription Login landing page. |
| Discount codes | Shopify Discounts (handled at checkout) |
| Gift cards | templates/gift_card.liquid |
| Metaobjects / metafields | Used heavily for ingredients, badges, selectors — see Product Pages |
Apps you might expect — but are NOT installed
If you've worked on Antelope Pets or Bocce's, you might look for these. They are not part of this theme:
| App | Notes |
|---|---|
| Algolia | No InstantSearch on collection pages — PLP uses native Shopify product listing |
| Swym Wishlist | No wishlist functionality |
| Attentive | SMS is handled through Klaviyo, not Attentive |
| Wholesale Gorilla | Ark is DTC-only on this theme |
| Accessibly | No third-party overlay. The theme ships its own Accessibility drawer in the footer. |
| Stockist | Not used. The store locator is our own Pinpoint Store Locator app. |
| Checkout Savings extension | Not used by Ark. The theme doesn't write the _theme_id cart attribute and doesn't read custom.shipping_cost, which that checkout extension relies on. |