Integrations

A Version can hold the public keys of a few third-party services. Fill them in once, click Save, and the checkout uses them on its next load; no deploy is needed. Admin → Versions → your version → General Configuration → Integrations.

Version General Configuration tab — The Integrations section of the General Configuration tab

Field	Prop	Notes
Google Tag Manager	`props.integrations.GTM_ID`	Your container id, `GTM-XXXXXXX`. Loads GTM on every checkout page and pushes the analytics events to the dataLayer.
Server Container URL (Optional)	`props.integrations.GTM_SERVER_URL`	Enable server-side GTM by adding your container URL, for example `https://gtm.mystore.com`. Leave empty for client-side only. Must be a full URL.
Pickup points map	`props.flags.pickupMap`	Which map renders the pickup selector: Off (a list, the default), Free (OpenFreeMap), which needs no key, or Google Maps.
Google Maps API Key	`props.integrations.GOOGLE_MAPS_API_KEY`	Shown only when the pickup map is set to Google Maps, and required then. The key must allow your store’s domain as an HTTP referrer. Without a key the map falls back to the free provider.
PayPal Client ID	`props.integrations.PAYPAL_CLIENT_ID`	From your PayPal Developer Dashboard, under your REST API app settings. Enables PayPal in the payment step and the PayPal express button.
PayPal Intent	`props.integrations.PAYPAL_INTENT`	Capture (immediate), the default, or Authorize (auth only). Use Authorize when your order management needs a valid transaction reference before capture, as some order-management systems do.

Only public client-side keys are stored here. Secrets your functions need go in Environment Variables, which are encrypted at rest.

Reading them from a component

The same values are exposed to custom components through useStoreInfo:

const { props } = useStoreInfo();
const integrations = props?.integrations as { GTM_ID?: string; PAYPAL_CLIENT_ID?: string } | undefined;
const gtmId = integrations?.GTM_ID;

The SDK types integrations loosely, so narrow it to the keys you read.

Analytics: what the checkout sends to GTM
Checkout Flags: the pickup map selector and the nearby pickup points flag
Managing Versions: the rest of the General Configuration tab

Overview

Start Here

AI Coding Agents

Core Concepts

Customization

Ollie Studio

Functions

CLI Reference

Ollie SDK

Analytics & Scripts

Tools & Tips

Product updates

Reading them from a component

​Reading them from a component

​Related

Reading them from a component

Related