Checkout Flags

Flags are per-Version switches that change how the checkout behaves without any code. They live in two tabs of the version page in the Admin (Versions → your version):

General Configuration holds the authentication flags and the pickup map selector, next to the version’s name, template, shipping modes and integrations.
Props Configuration holds the remaining flags, grouped by area, below the custom props.

Every flag is stored under props.flags of the version and is readable from a custom component through useStoreInfo().props.flags. A flag that was never touched resolves to the default listed below.

General Configuration

Authentication

Setting	Prop	Control	Default	What it does
Allow guest in Cart	`props.flags.allowGuest.cart`	toggle	on	Allow non-logged-in users on the cart page without creating an account.
Allow guest in Details	`props.flags.allowGuest.details`	toggle	on	Allow non-logged-in users on details pages without creating an account.
Use Ollie login	`props.flags.useOllieLogin`	toggle	on	Use Ollie’s login flow instead of redirecting to the store.
Require login to place order	`props.flags.requireLoginToPlaceOrder`	toggle	off	Ask a guest to sign in when they click to place the order, before it is sent. Must match the VTEX “require login to place order” setting: on without it, guests are asked to sign in for nothing. Default template only.

Integrations

Setting	Prop	Control	Default	What it does
Pickup points map	`props.flags.pickupMap`	`off` / `free` / `google`	`off`	Which map renders the pickup selector. “Free” needs no key; “Off” falls back to a list. “Google Maps” also needs the Google Maps API Key field that appears below it.

Setting both allowGuest.cart and allowGuest.details to off restricts the checkout to authenticated users. This is common for B2B stores that need to show customer-specific prices and payment conditions. See Ollie Login for how the login modal behaves.

Props Configuration

The Props Configuration tab lists 14 flags in four groups. Toggle them in the UI view, or edit the whole flags object at once in the JSON view, then click Save Changes.

Shipping & address

Setting	Prop	Control	Default	What it does
Show shipping in business days	`props.flags.showShippingInBusinessDays`	toggle	not set (behaves as off)	Display shipping ETAs as business-day counts instead of calendar dates.
Optimized shipping options	`props.flags.optimizedShippingOptions`	toggle	off	Filter shipping options and auto-pick the best when the current pick is unavailable.
Enable shipping simulation	`props.flags.enableShippingSimulation`	toggle	off	Let shoppers estimate shipping from the cart before reaching the shipping step.
Nearby pickup points (“see more stores”)	`props.flags.enableNearbyPickupPoints`	toggle	off	Adds “see more stores” to widen the pickup search past the default radius.
Use same billing address	`props.flags.useSameBillingAddress`	toggle	on	Default the billing address to the delivery address on credit-card payments.
Show shipping arrival date	`props.flags.showShippingArrivalDate`	toggle	not set (behaves as off)	Display estimated delivery as a full date instead of a duration.
Company (CNPJ) purchase flow	`props.flags.activeFlowCorporate`	toggle	off	Show the “purchasing as a company” toggle on the address step.
Show packages	`props.flags.showPackages`	`always` / `never` / `smart`	not set	When to display package split in the cart. “Smart” shows only for multi-package orders.

Payment

Setting	Prop	Control	Default	What it does
Enable pending PIX	`props.flags.enablePendingPix`	toggle	not set (behaves as off)	Persist unpaid PIX on a dedicated screen and hold the order-placed page until paid.
Express checkout buttons: Google Pay	`props.flags.expressCheckout.googlePay`	toggle	on	One-click wallet buttons shown at the top of the cart and checkout.
Express checkout buttons: Apple Pay	`props.flags.expressCheckout.applePay`	toggle	on	One-click wallet buttons shown at the top of the cart and checkout.
Express checkout buttons: PayPal	`props.flags.expressCheckout.paypal`	toggle	on	One-click wallet buttons shown at the top of the cart and checkout.

UI & summary

Setting	Prop	Control	Default	What it does
Show item totals on summary	`props.flags.showItemsCountWithoutQuantity`	toggle	on	Show “N items” on the summary instead of “N SKUs × quantity”.
Coupon input opened by default	`props.flags.showCouponCodeInputOpened`	toggle	off	Render the coupon-code input expanded when the page loads.
Show edit summary: Contact	`props.flags.showEditSummary.contact`	toggle	on	Let shoppers edit these sections directly from the summary sidebar.
Show edit summary: Shipping	`props.flags.showEditSummary.shipping`	toggle	on	Let shoppers edit these sections directly from the summary sidebar.

Tracking

Setting	Prop	Control	Default	What it does
Enable abandoned-cart tracking	`props.flags.enableAbandonedCartTracking`	toggle	on	Send abandoned-cart events to VTEX so it can run cart-recovery emails.

Reading a flag from a component

import { useStoreInfo } from '@ollie-shop/sdk';

export default function CouponHint() {
  const { props } = useStoreInfo();

  // Flags you never set are undefined here; the checkout applies the
  // defaults from the tables above internally.
  if (props?.flags?.showCouponCodeInputOpened) return null;

  return <p>Have a coupon? Open the coupon field in the summary.</p>;
}

Notes

Changes apply to new checkout page loads. Shoppers already in the checkout keep the previous value until they reload.
The JSON view of the Props tab shows the same flags object. The authentication flags and the pickup map are read-only there (edit them on the General tab), and the shipping, messages, and integrations buckets are read-only too.
Once a flag has been saved it cannot go back to “not set”. Turning a toggle off stores false.
If you need a behaviour you cannot find here, contact support.

Ollie Login: how the authentication flags and the native login modal work together
Integrations: the keys the Google Maps pickup map and GTM need
Steps, Font and Share Cart: the custom props that share the Props tab

Overview

Start Here

AI Coding Agents

Core Concepts

Customization

Ollie Studio

Functions

CLI Reference

Ollie SDK

Analytics & Scripts

Tools & Tips

Product updates

General Configuration

Authentication

Integrations

Props Configuration

Shipping & address

Payment

UI & summary

Tracking

Reading a flag from a component

Notes

​General Configuration

​Authentication

​Integrations

​Props Configuration

​Shipping & address

​Payment

​UI & summary

​Tracking

​Reading a flag from a component

​Notes

​Related

General Configuration

Authentication

Integrations

Props Configuration

Shipping & address

Payment

UI & summary

Tracking

Reading a flag from a component

Notes

Related