Skip to content

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.

AppCategoryStatusWhere it's wired
Junip ReviewsReviewsActivePDP & PLP review badges, Junip review app block on every product template, store key block
External review sync (reviews.* metafields)Reviews dataActiveOff-site (Amazon / Chewy) totals blended into every star rating. See below
KlaviyoEmail & SMSActiveFooter signup, popups, countdown timer
ReChargeSubscriptionsActivePDP subscribe option, account portal
GorgiasCustomer supportActive (link only)Footer "Contact Us" link, account help
Pinpoint Store LocatorStore locator (our own app)ActiveApp 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 ​

LocationSnippet / blockWhat it renders
Product detail page (under the title)junip-product-summary.liquidStars + full count ("2,342 reviews"). Clicking scrolls to the review list. With no reviews: a "Write a review" link.
Collection / search cardsjunip-product-plp.liquidAverage + stars + short count, e.g. 4.4 ★★★★☆ (2.3k). With no reviews: a "Write a review" link.
PLP headerreviews-aggregate-badge.liquidCollection-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 sectionThe full Junip review widget. On every product template.
Full review list (PDP), figuressection-blended-review-widget.liquid → blended-review-widget.liquid + blended-review-summary.liquidRewrites the average, star fill and count inside the Junip widget with the blended figures. See below.
Legacy wrappersection-product-reviews.liquid → junip-product-review.liquidHeadline + Junip mount point. Not used by any product template.

Metafields it reads ​

MetafieldTypePurpose
product.metafields.junip.rating_averageNumberAverage star rating
product.metafields.junip.rating_countNumberTotal number of reviews
shop.metafields.junip.store_keyStringJunip store identifier
shop.metafields.junip.onsite_enabledBooleanMaster switch for the onsite widget
shop.metafields.junip.review_count_enabledBooleanWhether 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.

MetafieldWhat it holds
product.metafields.reviews.blended_ratingAverage rating across all platforms (0–5)
product.metafields.reviews.blended_countTotal review count across all platforms
product.metafields.reviews.amazon_reviewsAmazon review count
product.metafields.reviews.chewy_reviewsChewy 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:

  1. A product "has off-site reviews" when amazon_reviews > 0, or chewy_reviews > 0, or blended_count is larger than Junip's rating_count.
  2. If it does, and blended_rating and blended_count are both above 0, the blended figures are used and the copy says "across all platforms".
  3. Otherwise Junip's own junip.rating_average / junip.rating_count are used, with no disclaimer.

Formatting is centralised so the same product never shows two different numbers:

HelperRuleExample
helper-review-rating.liquidOne decimal, truncated (not rounded), trailing .0 dropped. This matches what the Junip widget prints.4.59 → 4.5, 5.0 → 5
helper-review-count.liquidfull = 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.liquid waits 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.liquid covers 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:

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 ​

SourcePurpose
product.selling_plan_groupsThe subscription plans attached to a product (frequency, name)
product.selling_plan_allocationsDiscounted prices per plan
Snippet json-product-prices.liquidGenerates 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-access

The 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.

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:

FeatureWhere it lives
Site searchNative 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.
CartCustom Vue-powered drawer + native /cart endpoint
Customer accountsShopify new customer accounts — login, dashboard, order history are all hosted by Shopify; the theme only renders the custom Subscription Login landing page.
Discount codesShopify Discounts (handled at checkout)
Gift cardstemplates/gift_card.liquid
Metaobjects / metafieldsUsed 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:

AppNotes
AlgoliaNo InstantSearch on collection pages — PLP uses native Shopify product listing
Swym WishlistNo wishlist functionality
AttentiveSMS is handled through Klaviyo, not Attentive
Wholesale GorillaArk is DTC-only on this theme
AccessiblyNo third-party overlay. The theme ships its own Accessibility drawer in the footer.
StockistNot used. The store locator is our own Pinpoint Store Locator app.
Checkout Savings extensionNot 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.

Antelope Themes Documentation

Enter the password to access this site.