Navigation
Overview
Overview

Navidium Documentation

Everything you need to set up, customize, and manage Navidium. Explore our guides, tutorials, and API references to get started quickly and maximize your store's protection and revenue.

Navidium Shipping Protection
Merchant Guide

Run a shipping protection program that pays you, not an insurer.

Navidium Shipping Protection sells an optional damage/loss/theft add-on at checkout, then gives you the tools to file, resolve, automate, and brand every claim that comes back. This guide covers the whole thing, end to end.

100% of collected protection feesper Navidium's merchant study
Claims honored (≈40%)
Kept by you (≥60%)
Cost of refunds & replacements you pay outYour net margin, after honoring 100% of claims
This is a self-insurance model, not third-party insurance — see Section 1 for why that's actually the better deal for you.
01

Introduction

What Navidium Shipping Protection does

Navidium Shipping Protection is a Shopify app that lets you offer an optional protection add-on to customers at checkout, covering their order against loss, theft, or damage in transit. When something goes wrong, your customer can file a claim through a self-service portal you control, and you — or automated rules you configure — decide whether to refund them, send a replacement, or issue store credit.Everything about the program is configurable from inside the app: the price of protection, the look of the widget that sells it, the wording of every email a customer or your team receives, and the entire step-by-step claims journey your customers go through.

The app is built around two halves that work together:

  • The Protection Widgeta storefront upsell shown at cart or checkout that sells the protection add-on.
  • The Claims Systemthe tools for filing, resolving, automating, and branding everything that happens after a customer reports a problem.

The business model: why this is almost always a win for you

This is a self-insurance model, not third-party insurance. You collect the protection fee as your own revenue — Navidium does not take a percentage of it. In exchange, you honor valid claims yourself, using the app's tools to refund, replace, or credit affected customers. Navidium's only revenue is your monthly subscription fee; it never shares in your protection revenue or in your claims costs.

Key insight

This works the same way real insurance underwriting works. The fee you charge is priced above your expected claims cost across your full order volume, so the difference is your margin. Per Navidium's internal merchant study, stores that honor 100% of filed claims still retain, on average, at least 60% of the protection fees they collect. If insurance companies can make money pricing risk this way, you can too — except here, you keep the entire spread instead of handing it to an underwriter.

A note on numbers used elsewhere in this guide: some dashboard figures referenced come from a low-volume test store and aren't representative of a healthy production store's economics. Section 10 covers the revenue-vs-claims-cost comparison you should actually watch on your own dashboard.

02

Getting Started

App embeds & installation

Installation runs through Shopify's theme app embed system. The app's Home screen shows the live status of each embeddable piece:

Navidium Standard Widget
The current, recommended widget. When Active, it's visible on your storefront and is the main way protection is sold.
Claim Page
An optional embed that enables the customer-facing claim portal. When Active, customers can submit and track claims.
Navidium Classic Widget
A legacy, toggle-style widget kept for backward compatibility. Not recommended for new setups.
Shipping Protection (Cart Page block)
An older installation method, also legacy and not recommended.

For a new setup, keep the Standard Widget and Claim Page active, and leave the legacy options inactive unless you have a specific theme compatibility reason to use them.

Linking the claim portal on your storefront

Once Claim Page is active, the app generates a ready-to-use claims portal URL in the form https://{your-store}.myshopify.com/apps/claims, found under Claims → Claim Portal → Portal preview. Add this link to your site footer, navigation, or order confirmation emails so customers always know where to go if something goes wrong. The same screen has an Open portal editor button for live customization — see Section 15.

03

Storefront Widget

Standard vs Classic widget

Widget typeStyleStatusNotes
Standard WidgetButton-style checkout widgetCurrent / recommendedFour selectable visual templates, full content and style editor with live preview
Classic WidgetToggle / checkbox styleLegacy Simpler styling, kept for stores that installed it before Standard existed

Choosing a template (Standard Widget)

Clicking Change Template opens a picker with four visual styles, each shown with a live price preview against a sample $100 subtotal:

  • Branded card - a white card with an orange 'Protected Checkout' call-to-action, labeled 'Navidium shipping protection'.
  • Informational carda teal-accented card with an icon, a 'Learn more' link, and a teal call-to-action.
  • Minimal badgea compact dark 'Package Protection' badge, for a low-visual-weight placement.
  • Branded pilla teal pill-shaped button with a shield icon and a 'Powered by Navidium' badge.

Editing content & style

The Standard Widget editor is split into a Content tab and a Style tab, with a live preview pane that updates as you edit. Content is organized into four collapsible sections: General (logo upload), Heading, Learn More Popup, and CTA Button.

The Classic Widget instead exposes Main Title, Short Description, an Opted-In Message shown when protection stays selected, an Opted-Out Message shown as a disclaimer when the customer deselects it, and a Learn More URL.

Any unsaved change on either widget triggers a top banner with Discard and Save actions — changes aren't live until you click Save.

04

Pricing & Fees

Fee configuration lives under Settings → Fees, and is the single most important screen for the economics described in Section 1.

Percentage vs Static pricing

Protection Type can be set to Percentage (a flat percentage of each cart subtotal — 2.5% is Navidium's recommended starting point) or Static (a flat dollar amount). Static mode supports tiered rules: a table of From / To / Protection Fee rows lets you charge a different flat fee depending on the order's subtotal band, with a 'New Tier' button to add more bands.

Protection value bounds & rounding

In Percentage mode, the calculated fee is clamped between a configurable minimum and maximum dollar value (the two must differ by at least 2), so a percentage-based fee never becomes trivially small on a cheap order or unreasonably large on an expensive one. An 'Adjust Protection Price' setting (e.g. Rounding Up) controls how the fee rounds to a clean number.

Cart value threshold

A Max Threshold Value defines the cart subtotal above which the widget disappears entirely — useful if you don't want to offer protection on very large orders.

International pricing

Two toggles control international orders: Disable International hides the widget for international customers entirely, and Different Fee for International Customers lets you set a separate rate. Which countries count as 'home' vs 'international' is defined in Settings → Additional (Section 6).

Best practices

Start at the recommended 2–2.5% (or an equivalent flat fee), and use the Dashboard's revenue-vs-claims-cost comparison (Section 10) as your health check after a few weeks of real volume — not a single test order or a brand-new store with too little data. If claims cost consistently runs close to or above collected revenue, consider raising the fee slightly or tightening Exclusions (Section 5) on your highest-claim products before assuming the program isn't working.

05

Exclusions

Settings → Exclusions lets you remove specific products from protection eligibility by Product SKU, Product Type, or Product Collection — each its own tag-entry field where you type a value and press Enter to add it.

You then choose what happens when an excluded product is in the cart: Hide Widget Entirely removes the protection offer from that cart altogether, while Exclude Value leaves the widget visible but excludes that item's price from the fee calculation. Use exclusions for products you don't want to insure at all — digital goods, gift cards, or items already protected through another program.

06

Additional Settings

Settings → Additional covers four areas that don't fit neatly elsewhere:

Currency
Default Currency sets the currency used for protection fee calculations and display.
Fulfillments
Enable Order Fulfillments auto-marks the protection line item as fulfilled. Even though protection is digital, Shopify still expects every line item to reach a fulfilled state — otherwise an order can sit in an incomplete-looking status indefinitely. "Fulfill When" (e.g. Order Placed) controls the timing; merchants who want protection fulfilled only after other items physically ship can adjust this instead.
International Settings
Home Country defines which countries count as your home base for the international fee rules in Section 4 — every other country is treated as international.
Enhanced Disclaimer
Adds a custom property (a Property Name and Value you define) displayed beneath the protection line item at checkout — e.g. clarifying it's optional and not a shipping fee.
07

Product Settings

Settings → Product lets you rename and rebrand the underlying Shopify product that represents shipping protection, so its name, description, and image match the language and branding used on the widget itself. You can set a Product Name (required), a Product Description, and upload a product image (recommended 300×300px, 1:1 ratio, JPG/PNG/GIF). Keeping this in sync with your widget copy avoids a mismatch where the cart or order shows a generic name different from what the customer saw when they opted in.

08

App Permissions

Settings → App Update is a status page for the Shopify API permissions the app relies on. It tracks Store Credit permissions and Cart Transform permissions (typically granted automatically), and Discount permissions, which require an explicit "Request Scopes" action from you before discount-related features can be used. A Future Updates section surfaces any new permission requirements as the app evolves — check here if a feature seems unavailable and you suspect a missing permission.

09

Fraud Prevention

Settings → Fraud Prevention addresses a specific abuse pattern: shoppers attempting to check out with only the protection product in their cart, which is commonly linked to automated card-testing and other fraudulent activity. Even low-value fraudulent orders can generate chargebacks, payment disputes, and unnecessary risk.

Activating this feature blocks checkout when a cart contains only the protection product. It's implemented through Shopify's native Checkout Rules rather than purely inside the app. The in-app 'Activate Fraud Prevention' button and tutorial walk you through the underlying setup, which otherwise involves:

  1. Log in to your Shopify admin.
  2. Go to Settings → Checkout rules.
  3. Click Add rule.
  4. Select Fraud Order Prevention.
  5. Click Save, then Turn on.
See the tutorial video
10

Orders & Dashboard

Dashboard analytics

The Dashboard is your at-a-glance view of program health: total orders, protected orders, total revenue collected from protection, total claims cost, and a breakdown of claims by status (new, open, resolved, denied).

Watch this number

The most important comparison on this page is total revenue versus total claims cost. Healthy programs see claims cost run well under collected revenue — Navidium's benchmark is merchants keeping at least 60% of collected fees after honoring all claims. If your numbers look worse than that over a meaningful stretch of real volume, revisit your fee (Section 4) and exclusions (Section 5) before concluding the program isn't paying off.

Below the headline numbers: an Attachment Rate chart tracks the percentage of orders protected over time, a Protection Breakdown chart compares protected vs unprotected orders, an Orders with Claims chart compares total orders against total claims, and a Products with Claims list — filterable by reason (Lost, Stolen, Damaged, Other) — surfaces which products generate the most claims, often the fastest way to spot a packaging or fulfillment problem worth fixing at the source.

Orders list & order detail

The app's Orders screen mirrors your Shopify orders but adds protection status: each order is tagged Protected or Unprotected, with the protection fee paid shown alongside the order amount. Search by email or order number, filter to Protected or Unprotected only, and act directly from the list via View or File Claim. Opening an order shows protection status alongside fulfillment and payment status, line items, customer details, and addresses, with a File a Claim button available directly from the detail view.

11

Filing a Claim

Claims can be filed two ways: by your team, from inside the app, or by the customer, through the self-service Claim Portal (Section 15).

Filing on a customer's behalf

From an order, clicking File a Claim opens an Add New Claim form pre-filled with the order's general information (order number, date, customer name, email, subtotal, discount, taxes, amount paid). For each line item, choose a reason — Lost, Stolen, Damage, Empty, or None — or type a custom reason, and attach a photo and free-text description before submitting.

Customer self-service filing

Through the Claim Portal, customers work through a guided multi-step flow with a comparable, customer-friendly reason set (Damaged, Lost, Stolen, or 'Something else' for an open-ended reason). The full journey, and everything you can customize about it, is in Section 15. Claims filed this way appear in your dashboard immediately, and both you and the customer get notified at each step via the email templates in Section 14.

See the tutorial video
12

Resolving a Claim

Every claim has a status (e.g. New) that you update as you work it, an internal-only Comments section for your team to coordinate without the customer seeing it, and a Take Actions panel with four resolution options:

Reorder
Creates a new Shopify order to replace the claimed item(s). You can adjust quantities, add additional products, set a reason for the reorder, and choose whether to charge the customer, adjust inventory, and send a notification. The new order is auto-tagged (e.g. 'Navidium Reorder' plus a reference to the original order) so it's traceable later.
Refund
Issues a refund to the customer through Shopify's standard refund flow.
Store Credit
Issues credit through Shopify's native Store Credit system, applied directly to the customer's account and redeemable on a future purchase.
Deny Claim
Rejects the claim — use for claims outside your policy, like a missed submission window or an uncovered reason.

Whichever action you take, the customer is notified automatically through the corresponding email template (Section 14) — no need to message them separately unless you want to add something beyond the standard notification.

13

Claims Automation

Claims → Claim Automation lets you resolve high-confidence claims without manual review. Each rule follows an If / Then structure: one or more conditions (joined with AND / OR) that, when matched, trigger one or more actions.

ConditionsActions
Customer Tag, Customer Order Count, Customer Store Claim Count, Customer Navidium Claim Count, Customer City / Country / Zip-Province, Reason is, Product Tag / Collection / Title / Price / Inventory, Order Value, Order Tag, Shipping Method, DiscountDeny Claim, Auto Replacement (Reorder), Auto Refund, Requires Review, Hold
See the tutorial video
14

Branding & Email

Brand Kit

Claims → Brand Kit controls the sender identity and visual styling across every claim-related email: Merchant Name and Merchant Email, a Logo (PNG/JPG/WebP, max 2.5MB, square recommended), and a Brand Color used as the accent for buttons and highlights. A live preview shows exactly how a sample email block will look.

Email Settings

Claims → Email Settings splits into Merchant-facing and Customer-facing templates covering every stage of the lifecycle: Auto Refund, Auto Reorder, Auto Deny, Claim Review, Manual Refund, Manual Reorder, Manual Deny, and OTP Verification.

Each template has its own editor: an Activate toggle, sender name/email, subject line, a rich-text body with standard formatting controls, merge tags you can drop into the copy ({{order_number}}, {{items}}, {{refund amount}}, {{Rule Title}}, {{ refund / replacement }}), and a sandboxed live preview rendering the template with merge tags visible as placeholders.

15

Customer Claim Portal

The Claim Portal is the self-service flow customers use to file and submit a claim without contacting you directly. It's accessed at the URL from Section 2, and every screen is editable through Claims → Claim Portal → Open portal editor.

Portal-wide settings apply across the whole flow: Require OTP (sends an email verification code — always email-based, never SMS), Limit Claim Form to Protected Orders Only, and Prevent Claim Submit After (days from delivery, 0 = no limit). A Global Color Settings panel controls background and overlay colors throughout.

PageWhat the customer seesWhat you can customize
Search OrderEnter email + order number to look up their order.Short title, logo/image, fonts, colors.
Order ListPick the right order if multiple match. Short title, logo/image, fonts, colors.
Order DetailsSelect which product(s) are faulty, with 'Select all.'Short title.
ReasonsChoose Damaged, Lost, Stolen, or 'Something else.'Reason title text, 'Something else' label, colors.
Attachment PageExplain the issue (required) and optionally attach a photo.Short title; whether explanation text and photo are required per reason; field labels.
Refund-ReorderChoose Reorder or Refund (or any extra option you've added).Short title, button labels, custom action buttons.
Reorder Submit PageConfirm shipping address before the replacement ships.Title, paragraph copy, Next/Back button text.
Claim SuccessfulBranded confirmation that the claim is under review.Title, paragraph copy, button text, fonts.

Current limitation

There is no ongoing claim status-tracking page for customers beyond the confirmation screen. Status updates after submission are communicated entirely through the email notifications in Section 14, not a page customers can revisit. If asked 'where's my claim,' the honest answer today is: check your email, there's no tracking page yet.

Claim Workflow


Shipping Protection Customer Claim Portal Workflow

End-to-end claim flow from order verification to instant qualification and resolution.

Merchant Journey

Shipping Protection — Setup & Claim Management

17

Billing & Plans

Billing lets you change plans at any time; pick the tier that matches your monthly order volume.

PlanPriceOrder capClaims dashboard + portalAuto fulfillmentsRevenue share
Free$0/moUp to 50/moNot includedNot includedNone — you keep 100%
Essential$29.99/moUp to 500/mo*includedincludedNone — you keep 100%
Growth$49.99/moUp to 1000/mo*includedincludedNone — you keep 100%
Enterprise$99.99/moUnlimitedincludedincludedNone — you keep 100%

* Essential and Growth bill up to $99.99 for the month if you exceed the plan's order cap, rather than blocking checkout or cutting off the app.

Important

Downgrading away from a plan that includes the Claims Dashboard + Portal takes the customer-facing claim portal offline. Don't downgrade while you have open claims or while customers are actively being directed to your claims portal link, or they'll lose access to it.

18

Integrations

Integrations connects the app to tools you may already run, grouped into three categories:

CategoryIntegrationWhat it does
SubscriptionsSkioConfigure Skio subscription settings and webhook tokens.
SubscriptionsSEALConfigure SEAL subscription settings.
SubscriptionsLoopConnect Loop returns to sync settings.
SubscriptionsBold SubscriptionsInstall and manage the Bold subscription integration.
SubscriptionsStay AIConnect Stay AI to enable subscription workflows.
SubscriptionsRechargeConfigure Recharge alongside Navidium.
Support ChatGorgiasConnect your helpdesk to view and manage Navidium settings.
Support ChatReamazeConfigure Reamaze alongside Navidium.
Support ChatTawkConfigure Tawk alongside Navidium.
StorefrontHeadlessEnable headless storefront support and configure links.
StorefrontTap CartAdd a Navidium shipping protection block to your TapCart cart.

If your tech stack isn't listed, the same screen has a 'Request a Connector' option to ask Navidium's engineering team to build a custom integration.

19

Glossary

TermMeaning
Attach RateThe percentage of orders in a given period that included the protection add-on.
Protected / Unprotected OrderWhether a given order included the protection fee or not.
ClaimA report that a protected order was lost, stolen, damaged, or otherwise had an issue.
ReorderA resolution action that creates a new Shopify order to replace claimed item(s).
Store CreditA resolution action that issues credit via Shopify's native Store Credit system.
Brand KitThe shared sender name, email, logo, and accent color used across all claim emails.
Claim Automation RuleAn If/Then rule that automatically resolves matching claims without manual review.
Claim PortalThe customer-facing, fully brandable self-service flow for filing a claim.
OTPA one-time email verification code customers may need to enter before filing a claim.