📚 getPolicies()

Fetches published legal policies (e.g. Refund Policy, Privacy Policy) from Shopify — either from native policy fields or from custom CMS pages.

Can be used to power:

• Footer links like Terms & Conditions, Legal Notice, Privacy Policy
• CMS-driven policy pages with SEO-friendly URLs
• Dynamic display of only published policies

✅ What It Does​

• Fetches native Shopify policies via Storefront API
• Fetches custom policy pages via Shopify Pages API
• Allows native policies to be overridden by user-defined page handles
• Returns a unified list of PolicyEntry items

🧱 Native Policy Support (Shopify Limitation)​

Shopify officially supports only 4 native policies in the Storefront API:

type NativePolicyType =
  | "privacyPolicy"
  | "refundPolicy"
  | "shippingPolicy"
  | "termsOfService";

But in the Shopify Admin under Settings → Policies, you’ll see:

• Return and refund policy
• Privacy policy
• Terms of service
• Shipping policy
• Contact information
• Terms of sale
• Legal notice

🌍 Language Support​

You can pass a language parameter to control the language context for native policies.

const result = await getPolicies({
  language: "fr",
});

This uses Shopify’s Accept-Language header under the hood.

If your store is configured with Shopify Markets or a translation app, the correct translated policy body and URL will be returned.

🧩 Used with @nextshopkit/pro-development​

If you are using the Pro SDK client, you can call this function like so:

import {
  createShopifyClient,
  GetPoliciesOptions,
  FetchPoliciesResult,
} from "@nextshopkit/pro-development";

const client = createShopifyClient({
  shop: process.env.SHOPIFY_STORE_DOMAIN!,
  token: process.env.SHOPIFY_ACCESS_TOKEN!,
  apiVersion: "2025-01",
});

export const getPolicies = async (
  args?: GetPoliciesOptions
): Promise<FetchPoliciesResult> => client.getPolicies(args);

const { createShopifyClient } = require("@nextshopkit/pro-development");

const client = createShopifyClient({
  shop: process.env.SHOPIFY_STORE_DOMAIN,
  token: process.env.SHOPIFY_ACCESS_TOKEN,
  apiVersion: "2025-01",
});

const getPolicies = async (args) => {
  return await client.getPolicies(args);
};

Usage:

import { getPolicies } from "lib/nextshopkit/client";

const { data: PoliciesData, error: PoliciesError } = await getPolicies({
  language: "fr",
  customHandles: {
    contactInfo: "informations-de-contact",
    generalConditions: "conditions-generales-de-vente",
    legalNotice: "mentions-legales",
  },
  debug: true,
});

import { getPolicies } from "lib/nextshopkit/client";

const { data: PoliciesData, error: PoliciesError } = await getPolicies({
  language: "fr",
  customHandles: {
    contactInfo: "informations-de-contact",
    generalConditions: "conditions-generales-de-vente",
    legalNotice: "mentions-legales",
  },
  debug: true,
});

Shopify native policies can be localized using Shopify Markets or compatible translation apps.

However:

• The Storefront API does not accept a locale argument directly
• Translations are exposed based on the shop's active language context

If you want full control over translations, it's recommended to use customHandles and create one page per language version.

🛠️ Custom Pages via customHandles​

To overcome Shopify’s limitations, getPolicies() lets you pass customHandles to fetch pages from your CMS:

const result = await getPolicies(fetchShopify, {
  customHandles: {
    legalNotice: "mentions-legales",
    cookiePolicy: "politique-des-cookies",
  },
});

Each custom handle must match the handle of a Shopify Page.

Custom pages are fetched using the Pages API and returned just like native policies.

📘 Output Type​

Returns a list of PolicyEntry objects:

type PolicyEntry = {
  type: string;
  title: string;
  handle: string;
  id: string;
  published: boolean;
  from: "shop" | "page";
  url?: string;
};

You can render these dynamically or filter them by type.

✅ Next: Options →