Use this article to configure Ingrid Promise step by step in the Ingrid Merchant Platform. By the end, you will have a working Ingrid Promise checkout with warehouses, regions, carrier products and delivery categories, published and checked.
This article is for the person configuring Ingrid Promise, usually your Ingrid administrator, during configuration (phase 2 of your Ingrid Promise implementation). It is the hands-on companion to Promise: configuration.
Which interface this walkthrough covers: this walkthrough covers the Ingrid Merchant Platform at mad.ingrid.com, which is where Ingrid Promise configuration is done today. If your account has the new Unified Ingrid interface, the screens differ: the concepts in this walkthrough still apply, but the steps will not match exactly.
Why Ingrid Promise configuration matters
How you configure Ingrid Promise shapes what shoppers see at the moment they decide to buy. Getting the Ingrid Promise configuration right means:
Higher conversion: shoppers see relevant, clearly priced delivery options instead of a confusing list
Fewer support contacts: accurate delivery times and transparent pricing reduce "where is my order?" questions
Operational efficiency: carrier products mapped to the right regions mean orders route correctly from day one
Flexibility as you grow: add markets, carriers or delivery types without rebuilding your checkout
Deciding what to build, rather than how? Delivery setup patterns covers the three setup shapes most retailers end up in, and how to choose between them.
Prerequisites for configuring Ingrid Promise
Before you start configuring Ingrid Promise, make sure you have:
Completed scoping with your Ingrid implementation consultant: delivery offerings, carrier services and markets are agreed. See Promise: scoping.
Access to the Ingrid Merchant Platform: production at mad.ingrid.com, staging at mad-stage.ingrid.com
Carrier contracts in place: active agreements with the carriers you want to offer
Your warehouse addresses: the physical locations your orders ship from
External method IDs: the shipping method identifiers used in your WMS (warehouse management system), ERP (enterprise resource planning) system or e-commerce platform, so Ingrid can map to your systems
How to configure Ingrid Promise: setup guide
Ingrid Promise configuration follows a logical build-up: create the infrastructure first (where you ship from), then the geography (where you ship to), then the shipping services, and finally how they appear to shoppers.
You do all of this in Ingrid production. Changes are held as drafts until you publish them, so nothing reaches shoppers before you are ready.
Step 1: create a warehouse in Ingrid Promise
A warehouse represents the physical location your orders ship from. Every region you configure later must connect to a warehouse. To create a warehouse:
Sign in to the Ingrid Merchant Platform.
Go to
Delivery Checkout → Warehouses.Click "+ Add new".
Enter your warehouse details: name, address and contact information.
Publish your changes before moving on: click "Preview changes" in the top-right corner, review the changes, and click "Publish". Your warehouse is now available to connect to regions.
Full guide: Adding a new warehouse
Good to know: a warehouse can serve multiple regions, but each region connects to only one warehouse. If you ship from a single location, you only need one warehouse.
Step 2: create regions in Ingrid Promise
A region defines the geography where you offer delivery: typically a country, but it can be as granular as postal code ranges. To create a region:
Go to
Delivery Checkout → Regions.Click "+ Add new" at the bottom left.
Set a descriptive name (for example "Sweden", "Germany" or "Rest of EU"). The region name is internal only; shoppers never see it.
Set the region type to Countries included and select one or more countries.
Connect the region to a warehouse from step 1.
Click "Add". The region now appears in your regions list.
For detailed region options (postal code regions, country exclusions): Regions. Visual walkthrough: How do I add a region?
Tip: start with one region per country. You can always split a country into more granular regions later, for example separating a metro area from the rest of a country for same-day delivery.
Step 3: add carrier products to each region
Carrier products are the actual shipping services you offer. To add a carrier product to a region:
Open the region you created in step 2.
Scroll to the Carrier Products section.
Click "+ Add new".
Select a shipping method from the list of available carrier products.
Set the external method ID. The external method ID links the Ingrid carrier product to the matching shipping method in your WMS or ERP. See External method ID.
Define the cut-off time: the latest time an order can be placed to ship the same day.
Configure pricing and rules, as shown in the table below.
The table below shows the pricing and rule settings for an Ingrid Promise carrier product:
Setting | What it does | Learn more |
Base price | The default shipping price if no price rules apply | – |
Price rules | Conditional pricing, for example free shipping over a cart value threshold | – |
Filter rules | Control when this carrier product appears, for example by weight, cart value or country |
Full guide: Adding a carrier product
Tip: add all carrier products to the region before creating delivery categories. You need the carrier products in the next step.
Step 4: create delivery categories in Ingrid Promise
Delivery categories are what shoppers actually see in the Ingrid Checkout widget: labels like "Home delivery", "Pickup point" or "Express". Each delivery category groups one or more carrier products under a shopper-friendly name. You find the Delivery Categories section at the bottom of each region page. To create a delivery category:
In your region page, scroll to Delivery Categories at the bottom.
Click "+ Add".
Enter a base name (for example "Home delivery").
Select the delivery type: Delivery, Pickup, Mailbox or Instore.
Set the sort order, which controls the display position in the checkout. See Sort order.
Configure the delivery time: dynamic (calculated from carrier data and your cut-off times) or static. See Setting up delivery time.
Click "+ Add new" under carrier products to link one or more carrier products to this delivery category.
Configure the additional delivery category settings shown in the table below.
Set the preselection order, which determines which delivery category is auto-selected when the checkout loads: click "Set preselection order", drag and drop the delivery categories into your preferred order, and click "Accept".
The table below shows the additional settings for an Ingrid Promise delivery category:
Setting | What it does | Learn more |
Translations | The display name per language and locale. If no translation is set, the base name is shown. | |
Category labels | Visual labels like "Eco-friendly" or "Fastest", shown to shoppers | |
Category tags | System-level identifiers for your integration, not visible to shoppers | |
Filter rules | Control when this delivery category appears in the checkout |
Important: a delivery category must have at least one carrier product linked to appear in the checkout. Preselection works as a cascade: if the first delivery option is not available for a given address, the next one is selected automatically.
Full guides: Delivery categories · Adding a delivery category
Step 5: publish and check your Ingrid Promise configuration
To publish your Ingrid Promise configuration:
Click "Preview changes" in the top-right corner.
Review all pending changes.
Click "Publish". Your configuration is now live in Ingrid production.
To check that your Ingrid Promise configuration behaves as expected:
Open the Test Checkout Widget in the Ingrid Merchant Platform.
Enter a test address in each region you configured.
Verify that the correct delivery categories and carrier products appear.
Check that delivery times and prices display correctly. If something looks wrong, see the troubleshooting section below.
Your staging environment: before go-live, Ingrid replicates your finished Ingrid Promise configuration into staging, so that from launch onward you have a configured staging environment to test future changes in. The two Ingrid environments do not sync, so this is a deliberate copy rather than something that happens by itself.
Full testing and launch (the three testing layers, the end-to-end booking flow and go-live itself) is covered in Promise: testing and go-live. This walkthrough stops at "the configuration is correct".
Troubleshooting Ingrid Promise configuration
A delivery category does not appear in the checkout
Cause: no carrier product is linked to the delivery category, the delivery category is not active, or the changes were not published. Fix: check that at least one carrier product is added, verify that the delivery category is toggled to Active, then click "Preview changes" → "Publish".
The wrong delivery options appear for a country
Cause: the country is assigned to the wrong region, or carrier products were added to the wrong region. Fix: go to Delivery Checkout → Regions, verify that each country maps to the correct region, then check the carrier products inside that region.
A free shipping rule is not working
Cause: the price rule has the wrong threshold value or condition type, or it is applied to the wrong carrier product. Fix: open the carrier product, check Price rules, and verify that the condition is "Total Cart Value" with the correct amount, in the currency used for that region.
Delivery time shows as "Unknown" or looks wrong
Cause: delivery time is not configured for the delivery category, the warehouse schedule is missing, or no cut-off time is set. Fix: see Setting up delivery time: check whether you are using dynamic or static delivery time, and that all required fields are filled in.
Preselection does not work as expected
Cause: the preselection order is not set, or your preferred delivery category is not available for the test address. Fix: check the preselection order in the region settings. Preselection cascades, so test with an address where your preferred delivery category is genuinely available. See Preselection order.
Changes are not visible after saving
Cause: the changes were saved but not published. Fix: click "Preview changes", then "Publish". All Ingrid Promise configuration changes require publishing before they take effect.
Frequently asked questions about Ingrid Promise configuration
Can I configure Ingrid Promise myself, or does Ingrid need to do it?
You can do most of the Ingrid Promise configuration yourself. Your Ingrid implementation consultant supports you with the initial setup, training and review, and coaches your team to run Ingrid Promise independently afterward. See Can we do our own configuration of Ingrid Delivery Checkout?
How long does Ingrid Promise configuration take?
How long Ingrid Promise configuration takes depends on how many markets and carrier products you need. For what drives the timeline of a whole Ingrid implementation, see What shapes your timeline.
Can I check my Ingrid Promise configuration before shoppers see it?
Yes, you can check your Ingrid Promise configuration before shoppers see it. Configuration is held as a draft until you publish it, and the Test Checkout Widget shows exactly what shoppers will see.
What if I need a carrier that is not in the list?
Carrier products must be enabled for your account before they appear in the Ingrid Merchant Platform. Check the Ingrid carrier library for what is integrated, and ask your Ingrid implementation consultant to enable the carrier product.
Can I have different shipping prices per country?
Yes, you can have different shipping prices per country. Each region has its own carrier products with independent pricing and price rules, so base prices and free shipping thresholds can differ per region.
What happens if I publish a mistake?
If you publish a mistake, you can update and re-publish your Ingrid Promise configuration at any time. Changes take effect immediately after publishing.
How do I add a new market later?
To add a new market later, follow the same steps: create a region for the country, add carrier products, create delivery categories, set the preselection order and publish. Your existing Ingrid Promise configuration is unaffected.
Limitations of Ingrid Promise configuration
Each region connects to only one warehouse. If you ship the same region from several warehouses, ask your Ingrid implementation consultant about routing options.
Preselection preference (refining which pickup points are preselected) is off by default and must be enabled by Ingrid. See Preselection preference.
Delivery time calculations depend on carrier data availability. Not every carrier provides real-time delivery estimates.
Filter rules use AND logic within a single rule. For OR conditions, you may need multiple carrier products.
Not self-service: custom widget styling, carrier product activation and split checkout setups all need Ingrid involvement.
Related
Delivery setup patterns: which setup fits your business
Promise: configuration: what this phase covers and who does what
Promise: testing and go-live: the phase after configuration