Store Config

const config = await storefront.store.getConfig();

interface StoreConfig {
  store: StoreInfo;           // Business information
  seo: StoreSeo;              // SEO and social media
  payments: PaymentConfig;    // Payment methods
  navPages: NavPage[];        // Published navigation pages
  campaigns: Campaign[];      // Active campaigns
  features: FeatureFlags;     // Feature toggles
  analytics: AnalyticsConfig; // Analytics tracking
}

import { storefront } from '@/lib/storefront';

const config = await storefront.store.getConfig();

console.log(config.store.name);        // "My Store"
console.log(config.seo.seoTitle);      // "My Store - Quality Products"
console.log(config.payments.methods);  // ["stripe", "paytrail"]

// Cache for 5 minutes (recommended for store config)
const config = await storefront.store.getConfig({
  next: { revalidate: 300 }
});

import { cache } from 'react';
import { storefront } from '@/lib/storefront';

export const getStoreConfig = cache(async () => {
  return storefront.store.getConfig({
    next: { revalidate: 300 }
  });
});

const config = await storefront.store.getConfig();

// Find free shipping campaign
const freeShipping = config.campaigns.find(
  c => c.type === 'FREE_SHIPPING'
);

if (freeShipping?.FreeShippingCampaign) {
  const minSpend = freeShipping.FreeShippingCampaign.minimumSpend / 100;
  console.log(`Free shipping on orders over €${minSpend}`);
}

// Find buy X pay Y campaign
const buyXPayY = config.campaigns.find(
  c => c.type === 'BUY_X_PAY_Y'
);

if (buyXPayY?.BuyXPayYCampaign) {
  const { buyQuantity, payQuantity } = buyXPayY.BuyXPayYCampaign;
  console.log(`Buy ${buyQuantity}, pay for ${payQuantity}!`);
}

const config = await storefront.store.getConfig();

// Add Umami tracking script to your layout
if (config.analytics.umamiWebsiteId && config.analytics.umamiScriptUrl) {
  // In Next.js layout:
  // <Script src={config.analytics.umamiScriptUrl}
  //   data-website-id={config.analytics.umamiWebsiteId} />
}

import { Metadata } from 'next';
import { getStoreConfig } from '@/lib/actions/storeConfigActions';

export async function generateMetadata(): Promise<Metadata> {
  const config = await getStoreConfig();

  return {
    title: config.seo.seoTitle || config.store.name,
    description: config.seo.seoDescription,
    openGraph: {
      images: config.seo.openGraphImageUrl ? [config.seo.openGraphImageUrl] : [],
    },
  };
}

import { NotFoundError, AuthError } from '@putiikkipalvelu/storefront-sdk';

try {
  const config = await storefront.store.getConfig();
} catch (error) {
  if (error instanceof AuthError) {
    // Invalid API key
    console.error('Check your STOREFRONT_API_KEY');
  }
  if (error instanceof NotFoundError) {
    // Store not found
    console.error('Store does not exist');
  }
  throw error;
}