# Instacart Docs

- [Powering the future of grocery retail.](/index.md)

## search

- [Search the documentation](/search.md)

## ads

- [Carrot Ads API](/ads.md): The Carrot Ads API provides retailers with a comprehensive advertising solution that enables them to do the following:
- [Events](/ads/ads_guide/concepts/ad_events.md): Carrot Ads API events occur when a user sees or engages with an ad, such as viewing an ad, clicking an ad, or adding an advertised product to a cart. Whenever an event occurs, your e-commerce site sends the event to Instacart. The events are used for billing, generating ads metrics, training machine learning models, and auditing purposes.
- [Metrics](/ads/ads_guide/concepts/ad_metrics.md): To help you understand the impact of Carrot Ads on your storefront, you can view the metrics that are generated from the ad events you send. Metrics include ad revenue, clicks, views, and click-through rates.
- [Brand pages](/ads/ads_guide/concepts/brand_pages.md): Brand pages are landing pages with content that is curated by the brand advertiser. The brand page appears as a page within your storefront. When implementing brand pages, you retrieve the brand page and then retrieve the blocks of content that appear within the page.
- [Display placements](/ads/ads_guide/concepts/display_placements.md): Display placement ads are creative displays that allow advertisers to tell their brand story. When customers search for a product, display placement ads that are related to the search term or relevant to the customer’s past behavior can appear at the top of the search results list. For visibility, the word Sponsored appears after the banner.
- [Filters and catalog identifiers](/ads/ads_guide/concepts/filters.md): To use the FilterQuery object in Carrot Ads requests, the products in your catalog inventory file must include the identifiers that you plan to use to filter the ads. You'll need to ensure that the catalog file contains the necessary columns and values for the products you want to target. For help with setting up your catalog to support filters, contact your Instacart representative.
- [Sponsored products](/ads/ads_guide/concepts/sponsored_products.md): Sponsored products are items that appear in highly visible locations throughout the customer shopping journey. Carrot Ads API returns a maximum of 100 sponsored products per request. When you display sponsored products, the word "Sponsored" must appear on the item card.
- [Frequently asked questions](/ads/ads_guide/faqs.md): If you can't find the answer to your question here, you can ask Instacart Technical Support by using the Enterprise Service Desk.
- [Get an access token](/ads/ads_guide/tutorials/get_a_client_access_token.md): Learn how to authenticate and get an access token in a development environment.
- [Implement Carrot Ads API](/ads/ads_guide/tutorials/implement_carrot_ads_api.md): Learn how to get sponsored products using the Carrot Ads API and display them. Then learn how to send ad events when a user views or engages with a sponsored product item card.
- [Get a brand page](/ads/api/ads/brand_page.md): Retrieves a brand page that is associated with the display placement ad that is clicked by a customer. Send the click as the value for the slug field. The response returns a page URL, the top most banner, and an ordered list of brand page block ids that identify the blocks to appear in the page. Use the Get a brand page block endpoint to retrieve the block content.
- [Get a brand page block](/ads/api/ads/brand_page_block.md): Retrieves a block of content to display within a brand page. Content can be anything the advertiser wants to display on the page, such as additional banners or lists of products. Send one blockversionedid per request in the order in which the ids appeared in the orderedversionedblockids array returned by the Get a brand page endpoint.
- [Changelog](/ads/api/ads/changelog.md): The changelog summarizes the updates and enhancements made to the Carrot Ads API. The most recent changes are listed first. All changes are non-breaking changes.
- [Get display placements](/ads/api/ads/display_placements.md): Retrieves display placements to display in banners on your site, such as display ads, shoppable display ads, and shoppable video ads. Specify the context in the request body.
- [Ingest orders from a third-party system](/ads/api/ads/ingest_orders.md): Ingests orders that were fulfilled by a provider other than Instacart. To include this information in the ads metrics, orders must be sent within three days of the order creation date.
- [Ads API endpoints overview](/ads/api/ads/overview.md): The Carrot Ads API contains the following resource endpoints:
- [Get sponsored products](/ads/api/ads/sponsored_products.md): Retrieves sponsored products ad content that you can display in a component on your site, such as an item card or carousel. Specify the context in the request body.
- [Track ad events](/ads/api/ads/track.md): Sends ad-related events from a retailer's site to Instacart. Events capture user actions such as clicks, add-to-cart actions, backend served impressions, and frontend viewport impressions (1 pixel and viewable). The events are used for billing, generating metrics, training machine learning models, and auditing purposes.
- [Authentication](/ads/api/authentication.md): Returns an access token. The access token must be included in all other requests as a Bearer token. Before you begin, ensure you have a client ID and secret from Instacart. You need to pass these values in the request.
- [Error and status codes](/ads/error_and_status_codes.md)

## ads_manager

- [Advertising on Instacart](/ads_manager.md): Instacart Ads help brands attract and engage customers at every stage of the shopping journey, from initial keyword search and aisle browsing through checkout. Using Ads Manager, you can create campaigns, manage your product library, and measure performance with closed-loop reporting.
- [Account billing and payment](/ads_manager/account_billing_and_payment.md): Change your credit card on file
- [Alternative text requirements](/ads_manager/alternative_text_requirements.md): Brand imagery appears on Instacart in various formats—
- [Changelog](/ads_manager/changelog.md): The changelog is a chronological record of partner-facing changes to Instacart Ads Manager. The most recent changes are listed first.
- [How we measure clicks and impressions](/ads_manager/data_and_analytics/how_we_measure_clicks_and_impressions.md): Ads Manager is a self-serve platform that lets advertisers create and manage campaigns, track campaign performance, and export metrics.
- [Insights Center](/ads_manager/data_and_analytics/insights_center.md): The Insights Center provides data and metrics on your brands' performance. Access sales and share data at the daily and universal product code (UPC) level from across the Instacart Ads ecosystem in a syndicated hierarchy with thousands of categories and subcategories rooted in the Nielsen hierarchy. You can create, customize, save, and export reports subject to Instacart's data licensing terms.
- [Linear attribution reporting](/ads_manager/data_and_analytics/linear_attribution_reporting.md): Instacart Ads historically used last touch attribution for sales reporting within each sponsored product and display ad format. As of August 1, 2022, both Ads Manager and Instacart Ads API reporting views primarily use linear attribution, with an option to see an updated last touch model for comparison. This change only affects sales reporting data for dates August 1, 2022, and onward.
- [Data and analytics](/ads_manager/data_and_analytics/overview.md): Data and analytics tools in Ads Manager give you the insights you need to understand your advertising performance, market position, and customer behavior on Instacart. Access reporting dashboards, attribution models, and competitive benchmarking to make data-driven decisions about your advertising strategy.
- [Sell sheets](/ads_manager/data_and_analytics/sell_sheets.md): Sell sheets describe a collection of products, their potential value to retailers, and why retailers should add them to their store shelves. With sell sheets, brands can—
- [Share of digital shelf](/ads_manager/data_and_analytics/share_of_digital_shelf.md): Share of digital shelf is the percentage of category impressions your brand receives benchmarked against other brands in its category.
- [Data subscription agreement](/ads_manager/data_subscription_agreement.md): This Data Subscription Terms (the "Terms") sets forth the terms and conditions applicable to Data subscriptions between the Eversight Inc., an affiliate of Maplebear Inc. d/b/a Instacart ("Provider") and the Party subscribing to the Data set forth on the applicable Order Form ("Subscriber"). Subscriber and Provider may be referred to collectively as the "Parties" or individually as a "Party." Provider's offer of the Data via Order Form, and Subscriber's purchase of the corresponding Subscription, constitutes each Party's respective acceptance of and their entry into these Terms, and each Party's agreement to be bound by the terms hereof. Provider may update the Terms from time to time without notice to Subscriber. Unless defined elsewhere in this Terms, terms in initial capital letters have the meanings set forth in Section 9 (Definitions).
- [Display creative guidelines](/ads_manager/display_ads/display_creative_guidelines.md): Use these guidelines when adding creative assets to your display ad groups. Learn more about display ads.
- [Duplicating display campaigns and ad groups](/ads_manager/display_ads/duplicating_display_campaigns_and_ad_groups.md): You can duplicate existing campaigns/ad groups and edit the details instead of creating new ones from scratch.
- [Introduction to display ads](/ads_manager/display_ads/introduction_to_display_ads.md): Display ads reach consumers in a targeted way throughout the shopping journey. You can access the display ad format under the Reach and Build your own campaign objectives. Learn more about campaign objectives.
- [Managing display ads](/ads_manager/display_ads/managing_display_ads.md): Check campaign or ad group status
- [Managing legacy landing pages](/ads_manager/display_ads/managing_legacy_landing_pages.md): We recently introduced brand pages as your brand's shoppable home on Instacart. If you create a display ad group after July 6, 2022, customers who click on your ads redirect to a brand page to continue their journey with your brand.
- [Measuring display ad performance](/ads_manager/display_ads/measuring_display_ad_performance.md): Ads Manager reports performance data in Pacific Time. Metrics update within 24 hours, and a banner appears in Ads Manager if there's a delay.
- [Display ads](/ads_manager/display_ads/overview.md): Display ads reach customers in a targeted way throughout the shopping journey. Place banner ads across discovery surfaces like storefronts, departments, and aisles using keyword or behavioral targeting. Display ads use a cost-per-impression (CPM) bidding model and link through to your brand's Page on Instacart.
- [Setting up display ad groups](/ads_manager/display_ads/setting_up_display_ad_groups.md): Each display ad campaign can contain multiple ad groups. Each ad group contains 1 display creative customers see, according to the targeting criteria you set.
- [Set up display campaigns](/ads_manager/display_ads/setting_up_display_campaigns.md): To create a new campaign:
- [Setting up shoppable display ads](/ads_manager/display_ads/setting_up_shoppable_display_ads.md): Each shoppable display ad campaign can contain multiple ad groups. Each ad group contains 1 display creative customers see, according to the targeting criteria you set.
- [Shoppable display ads on Caper Carts](/ads_manager/display_ads/shoppable_display_ads_on_caper_carts.md): Your single advertising campaign can now connect with relevant customers in-store on Caper Carts. Starting April 14, 2025, shoppable campaigns display on Caper Carts when 1 or more pinned products are in stock at applicable retailers.
- [Identifying campaign objectives](/ads_manager/identifying_campaign_objectives.md): Instacart Ads creates campaigns based on your brand's marketing objectives. Once you identify your campaign objective, we offer a recommended campaign path to achieve your goals. These campaign paths pre-formulate with tactics geared toward your selected objective.
- [Inspiration ad creative guidelines](/ads_manager/inspiration_ads/inspiration_ad_creative_guidelines.md): Use these guidelines when adding creative assets to your recipe ad.
- [Introduction to inspiration ads](/ads_manager/inspiration_ads/introduction_to_inspiration_ads.md): Inspiration ads are flexible merchandising solutions that spark out-of-aisle discovery. This helps you reach consumers with a curated experience at a moment that might not be possible with products alone. Designed for long-term brand equity impact, Inspiration Ads drive impressions and connect you with new consumers.
- [Manage inspiration ads](/ads_manager/inspiration_ads/manage_inspiration_ads.md): Check campaign or ad group status
- [Measure inspiration ads](/ads_manager/inspiration_ads/measure_inspiration_ads.md): Analytics
- [Inspiration ads](/ads_manager/inspiration_ads/overview.md): Inspiration ads are flexible merchandising solutions that spark out-of-aisle discovery on Instacart. Designed for long-term brand equity impact, they help you reach customers with curated experiences — like shoppable recipe ads — at moments that aren't possible with products alone. Inspiration ads use a cost-per-impression (CPM) bidding model and support both keyword and behavioral targeting.
- [Set up inspiration ads](/ads_manager/inspiration_ads/set_up_inspiration_ads.md): Each inspiration ad campaign can contain multiple ad groups. Each ad group contains 1 ad customers see, according to the targeting criteria you set.
- [Instacart ads additional terms](/ads_manager/instacart_ads_additional_terms.md): Last updated: April 9, 2025
- [Instacart ads terms and conditions](/ads_manager/instacart_ads_terms_and_conditions.md): These Instacart Ads Terms and Conditions (these "Terms") govern Company's purchase of Services (defined below) from Instacart or its affiliates with respect to the Order or Order Form to which these Terms are attached or incorporated. BY REGISTERING FOR OR USING THE SERVICES, COMPANY (ON BEHALF OF ITSELF OR THE ADVERTISER IT REPRESENTS) AGREES TO BE BOUND BY THESE TERMS, INCLUDING ANY PRODUCT-SPECIFIC TERMS AND AD POLICIES, AND THE ORDER OR ORDER FORM. Instacart and Company are each referred to in these Terms as a "Party" and collectively as the "Parties."
- [Introduction to advertising on Instacart](/ads_manager/introduction_to_advertising_on_instacart.md): Instacart offers a large and growing ads ecosystem that helps you reach customers on Instacart Marketplace, grocery ecommerce sites, and on AI-powered smart carts in-store.
- [Managing your account](/ads_manager/managing_your_account.md): Change your email address
- [Media Rating Council accreditation](/ads_manager/media_rating_council_accreditation.md): The Media Rating Council (MRC) accredits certain metrics that meet the industry standard.
- [Introduction to Pages](/ads_manager/pages/introduction_to_pages.md): A Page is your brand's shoppable destination on Instacart. Consumers can explore your products, see pricing, add to cart, and check out.
- [Managing and measuring page performance](/ads_manager/pages/managing_and_measuring_page_performance.md): Once Instacart approves your Page, with the exception of a few elements listed below, you can still update the design and included products. Any updated fields are resubmitted for review. The existing page version stays live until the review completes.
- [Pages](/ads_manager/pages/overview.md): Pages are your brand's shoppable destinations on Instacart. Customers can explore your products, see pricing, add items to cart, and check out — all from a customizable landing page you build directly in Ads Manager. Pages are free to create and can be used as landing pages for display ad campaigns or linked from external media.
- [Page review process](/ads_manager/pages/page_review_process.md): After you set up your Page, we review it before it goes live.
- [Set up a Recipe page](/ads_manager/pages/set_up_a_recipe_page.md): All Recipe ads click through to a Recipe page. The Recipe page has all of the relevant recipe information.
- [Setting up pages](/ads_manager/pages/setting_up_pages.md): Contact your Account Manager if you don't have access to the Create pages feature.
- [Policies](/ads_manager/policies.md): Content
- [Managing and measuring brand promotions](/ads_manager/promotions/managing_and_measuring_promotions.md): Manage promotions
- [Brand promotions](/ads_manager/promotions/overview.md): Brand promotions on Instacart help you drive product trial, build baskets, and fuel cross-category purchases. Offer flexible promotional formats like "Spend X, Save Y" and free gift campaigns to reach customers with compelling incentives. Brand promotions are organized into promotion groups for streamlined management and reporting.
- [Setting up brand promotion groups](/ads_manager/promotions/setting_up_promotion_groups.md): All promotions belong to promotion groups. Before setting up a new promotion, you must create a group for it to live under.
- [Setting up brand promotions](/ads_manager/promotions/setting_up_promotions.md): All promotions belong to promotion groups. Before setting up a new promotion, you must create a promotion group for it to live under. Learn more about setting up promotion groups.
- [Billing and budgets for promotion groups](/ads_manager/retailer_promotions/billing_and_budgets.md): Retailer Promotions use a redemption-based billing model — you are charged only when a customer successfully redeems your promotion at checkout and the order is delivered. You are charged the savings amount per redemption only. This page explains how charges are calculated, how billing works, and how to manage your total budget.
- [Creating a promotion group](/ads_manager/retailer_promotions/creating_promotion_groups.md): This page walks you through setting up a Retailer Promotion group in Ads Manager. Creating a promotion group takes about 5 minutes.
- [Data exports](/ads_manager/retailer_promotions/data_exports.md): You can download a CSV file of your promotion groups campaign performance data for deeper analysis, sharing with stakeholders, or record-keeping.
- [Introduction to retailer promotions](/ads_manager/retailer_promotions/introduction.md): Retailer Promotions are basket-level discount incentives that retailer advertisers can create and manage directly in Instacart Ads Manager. By offering automatic discounts at checkout, Retailer Promotions encourage Instacart customers to shop with your store and grow basket size.
- [Managing promotion groups](/ads_manager/retailer_promotions/managing_promotion_groups.md): After launching a promotion, you can monitor its status, make certain edits, pause or end it, and view its performance — all from the Promotion groups page in Ads Manager.
- [Measuring promotion group performance](/ads_manager/retailer_promotions/measuring_performance.md): Ads Manager provides real-time performance reporting for each of your promotion groups. Use reporting to understand how your promotions are performing, how spend is tracking against your budget, and whether your promotions are driving customer behavior.
- [Retailer promotions](/ads_manager/retailer_promotions/overview.md): Retailer Promotions are basket-level discount incentives that retailer advertisers can create and manage directly in Instacart Ads Manager. By offering automatic discounts at checkout, Retailer Promotions encourage Instacart customers to shop with your store and grow basket size.
- [Introduction to shoppable video ads](/ads_manager/shoppable_video_ads/introduction_to_shoppable_video_ads.md): Shoppable video ads are targeted videos that feature both dynamic content and direct add-to-cart functionality. Now, you can bring together the best of storytelling and conversion on Instacart.
- [Managing shoppable video ads](/ads_manager/shoppable_video_ads/managing_shoppable_video_ads.md): Check campaign status
- [Measuring shoppable video ads](/ads_manager/shoppable_video_ads/measuring_shoppable_video_ads.md): Shoppable video analytics
- [Shoppable video ads](/ads_manager/shoppable_video_ads/overview.md): Shoppable video ads combine video storytelling with direct add-to-cart functionality on Instacart. Bring together dynamic content and conversion by pairing video creatives with a product carousel that lets customers shop while they watch. Shoppable video ads use a cost-per-impression (CPM) bidding model and support both keyword and behavioral targeting.
- [Setting up shoppable video ads](/ads_manager/shoppable_video_ads/setting_up_shoppable_video_ads.md): Each shoppable video ad campaign can contain multiple ad groups. Each ad group has 1 video. Your targeting criteria determine which customers see that video.
- [Shoppable video ads creative guidelines](/ads_manager/shoppable_video_ads/shoppable_video_ads_creative_guidelines.md): Use these guidelines when adding creative assets to your display ad groups. Learn more about setting up shoppable video ads.
- [Adding sponsored product campaign billing details](/ads_manager/sponsored_products/adding_sponsored_product_campaign_billing_details.md): You can specify in Ads Manager some additional billing details for each of your ad campaigns which we'll include when generating your monthly invoice. These are just informational fields for your reference, but some advertisers find it helpful to have these details included for their own accounting.
- [Change to impression reporting for sponsored products](/ads_manager/sponsored_products/change_to_impression_reporting_for_sponsored_products.md): Improving how we report impressions
- [Creating sponsored product ad groups](/ads_manager/sponsored_products/creating_sponsored_product_ad_groups.md): Sponsored product campaigns contain ad groups, which are groups of similar sponsored products. Every campaign needs at least one ad group to launch.
- [Creating sponsored product campaigns](/ads_manager/sponsored_products/creating_sponsored_product_campaigns.md): All sponsored products belong to ad groups, which belong to campaigns. Before setting up a new sponsored product, you must create a campaign and ad group for it to live under.
- [Duplicating sponsored product campaigns and ad groups](/ads_manager/sponsored_products/duplicating_sponsored_product_campaigns_and_ad_groups.md): You can duplicate existing campaigns/ad groups and edit the details instead of creating new ones from scratch.
- [Improving sponsored product performance](/ads_manager/sponsored_products/improving_sponsored_product_performance.md): In addition to reviewing metrics, you can take other proactive steps to get the most out of your ads.
- [Introduction to sponsored products](/ads_manager/sponsored_products/introduction_to_sponsored_products.md): Sponsored product ads highlight your product throughout the consumer journey. Consumers see sponsored product ads on the Instacart homepage, in search results, and while browsing, among other places.
- [Managing sponsored product ad groups](/ads_manager/sponsored_products/managing_sponsored_product_ad_groups.md): You might decide to make some adjustments after creating an ad group. You can pause ad groups, add keywords, change the maximum cost-per-click (CPC) bid, and more.
- [Managing sponsored product ads](/ads_manager/sponsored_products/managing_sponsored_product_ads.md): You can view sponsored product ads in the Products tab of an ad group's dashboard. To open the Products tab—
- [Managing sponsored product campaigns](/ads_manager/sponsored_products/managing_sponsored_product_campaigns.md): You might decide to make some adjustments after creating a campaign. You can pause, delete, or edit your campaign.
- [Measuring sponsored product performance](/ads_manager/sponsored_products/measuring_sponsored_product_performance.md): Ads Manager shows a variety of metrics to help you understand your sponsored product performance.
- [Sponsored products](/ads_manager/sponsored_products/overview.md): Sponsored product ads highlight your products throughout the customer journey on Instacart. Customers see sponsored product ads on the homepage, in search results, and while browsing. Using a cost-per-click (CPC) bidding model, you only pay when a customer clicks on your ad.
- [Sponsored product bidding](/ads_manager/sponsored_products/sponsored_product_bidding.md): Before your ads show on Instacart, you must participate in auctions to win ad placements. We offer ad placements in multiple locations, including (but not limited to)—
- [Plan your first retailer promotion](/ads_manager/tutorials/retailer_ads_promotions.md): Tutorial for retailer advertisers—learn how retailer promotions work in Ads Manager, what to configure, and how to measure them.
- [Two-factor authentication](/ads_manager/two_factor_authentication.md): To better secure your Ads Manager account, you can set up two-factor authentication.
- [Updating your product library](/ads_manager/updating_your_product_library.md): Your product library contains all of the products on Instacart that we can associate to your brand. After claiming your brand, you can add and remove products and edit product information to promote consistency across multiple retailers. Please note, we only show UPCs that retailers sell on their virtual stores on Instacart.

## ads_partners

- [Product content guidelines](/ads_partners.md): As an advertising partner, you can control how product information—including images, description, size, and other details—is displayed to customers across Instacart Marketplace and retailer storefronts. Use these resources to understand how Instacart handles product content and how you can manage content to ensure a consistent, high-quality customer experience.
- [Sponsored Products pagination](/ads_partners/carrot_ads_api/pagination_for_sponsored_products.md)
- [Changelog](/ads_partners/changelog.md): The changelog is a chronological record of changes to the guidelines used by advertising partners to submit product content to Instacart.
- [Brand name](/ads_partners/product_content_guidelines/brand_name.md): The brand name as it appears on the product packaging. This is what customers recognize when shopping for your products.
- [Images](/ads_partners/product_content_guidelines/images.md): Product images are one of the most influential factors in a customer's purchasing decision. Instacart displays images from multiple sources—retailers, content service providers (CSPs), and product library in Ads Manager—and uses source prioritization logic to determine which image is displayed on the storefront.
- [Product attribute guidelines](/ads_partners/product_content_guidelines/overview.md): Each product attribute submitted to Instacart must meet specific formatting requirements. Follow these guidelines to ensure your brand name, product title, images, and other attributes are accepted and display correctly across Instacart Marketplace and retailer storefronts.
- [Product title](/ads_partners/product_content_guidelines/product_title.md): The product title describes what the item is. This appears on product pages and helps customers find your product when they search.
- [Size](/ads_partners/product_content_guidelines/size.md): Size is a composite attribute made up of several data values that together determine how a product's size appears on the storefront.
- [Content Service Providers](/ads_partners/product_content_management/content_service_providers.md): A content service provider (CSP) is a third-party platform that aggregates your product data and distributes it to retailers and ecommerce partners, including Instacart. Working with a CSP is the primary way you can syndicate product content—including images, product names, sizes, and other attributes—to Instacart at scale.
- [Content management options](/ads_partners/product_content_management/overview.md): Instacart supports two ways to submit and manage product content: through a content service provider (CSP) or directly using the product library in Ads Manager. Use these topics to understand how each method works and how source prioritization determines what displays on storefronts.
- [Product library in Ads Manager](/ads_partners/product_content_management/product_library.md): The product library in Ads Manager displays all of a brand's products currently in the retailer's catalog on Instacart. For each product, the tool displays the product's image, along with details like brand name, product size, and product name.
- [Product content on Instacart](/ads_partners/product_content_overview/overview.md): This section explains how product information flows through the Instacart platform—from the sources Instacart draws on, to how content is prioritized and where it ultimately appears. Understanding these concepts helps you make informed decisions about how to submit and manage your brand's product content.
- [Product details page](/ads_partners/product_content_overview/product_details_page.md): Product details pages (PDPs) are the primary container for product information displayed to customers on the Instacart Enterprise Platform, designed to showcase individual products consistently and effectively. PDPs provide the information customers need to make informed purchasing decisions.
- [Information sources](/ads_partners/product_content_overview/product_information_sources.md): Instacart integrates data from multiple sources to ensure that the product information displayed to customers is accurate, consistent, and aligned with regulatory and brand requirements.
- [Product availability on retailer storefronts](/ads_partners/product_content_overview/products_on_instacart_storefronts.md): Retailer-provided information forms the foundation of the Instacart product catalog. In general, a product can be shown on a retailer storefront when the retailer adds a product's UPC to their catalog—either by uploading an inventory file or through their Instacart retailer dashboard—and provides the required data to indicate that the product is available.
- [Content source prioritization](/ads_partners/product_content_overview/source_prioritization.md): When product content is available from multiple sources—retailers, content service providers (CSPs), and the product library in Ads Manager—Instacart applies source prioritization logic to determine which value is displayed on the storefront. This logic varies by content type and attribute.
- [Availability FAQs](/ads_partners/troubleshooting/availability.md): Use this section to troubleshoot situations where a product is not appearing as expected—for example, when a product is available on a retailer's shelf or website but cannot be found on Instacart Marketplace. Availability issues are often related to how a product's UPC is set up in a retailer's inventory file or Instacart dashboard. In most cases, the cause is unrelated to product content.
- [Core attribute FAQs](/ads_partners/troubleshooting/core_attributes.md): Use this section to troubleshoot issues with core product attributes such as brand name, product title, size, and description. Attribute display problems are often related to source prioritization, a pending CSP submission, or retailer-level overrides.
- [General content FAQs](/ads_partners/troubleshooting/general_content.md): Use this section to troubleshoot issues with product content such as incorrect attributes, missing information, or content that isn't displaying as expected. Problems are often related to preferred CSP configuration, a rejected CSP submission, retailer-level overrides, or a delay in content processing. If standard troubleshooting doesn't resolve the issue, this section also covers how to request further investigation.
- [Image FAQs](/ads_partners/troubleshooting/images.md): Use this section to troubleshoot missing images, incorrect images, or images that display correctly at some retailers but not others. Image display problems are often related to source prioritization—images can come from the retailer, a CSP, or the product library in Ads Manager. Identifying the right fix starts with determining which source is currently taking priority for the affected product.
- [Troubleshooting](/ads_partners/troubleshooting/overview.md): Use this section to diagnose and resolve common issues with product content that isn't displaying as expected on Instacart. Most display problems fall into a small set of root causes related to source prioritization, retailer configuration, or submission status.

## catalog

- [Catalog overview](/catalog.md): A catalog is a library of every possible product that can be sold. Instacart has an extensive Universal Catalog that includes products commonly sold across multiple retailers. For each product, Instacart uses third party sources to obtain the product's attributes at the UPC level. For example, the Universal Catalog includes different brands of milk and their associated attributes, such as images, product description, ingredients, nutritional facts, and storage directions.
- [API authentication](/catalog/catalog_api/api-authentication.md): To make requests to the Catalog APIs, you need to generate a bearer token.
- [Batching requests](/catalog/catalog_api/batching-requests.md): Both the product API and the item API have a batch version that you can use to update multiple products or items at once.
- [Blackout period specifications](/catalog/catalog_api/item/blackout-period-specifications.md): Use the blackout_times array to temporarily disable product availability for a specific interval of time.
- [Configurable products specifications](/catalog/catalog_api/item/configurable-products-specifications.md): Some products have configurations associated with them. For example, customers can add a variety of things to sandwiches, such as lettuce, tomatoes, and onions. To define these configurations, use the configurable_products field.
- [Item tax data specifications](/catalog/catalog_api/item/item-tax-data.md): Use the itemtaxdata object to provide tax information for an item. The object can contain one or more of the following tax type keys:
- [Promotion specifications](/catalog/catalog_api/item/promotion-specifications.md): Use the promotion object to provide promotion data for an item.
- [Item API request overview](/catalog/catalog_api/item/request-overview.md): POST /v2/data_ingestion/catalog/item/submission
- [Retailer flyer data specifications](/catalog/catalog_api/item/retailer-flyer-data.md): Use the retailerflyerdata object to associate flyer deals with an item. The object is keyed by flyer identifier (lowercase alphanumeric with hyphens).
- [Tare packaging specifications](/catalog/catalog_api/item/tare-packaging.md): Use the tare_packaging array to provide container options for items sold by weight. During the shopping flow, the customer selects a container from the list you provide.
- [Catalog API overview](/catalog/catalog_api/overview.md): You can use the Catalog API to create new products or update existing products and items. When you use the API to update your catalog, only the attributes contained in the API request are updated.
- [Additional images specifications](/catalog/catalog_api/product/additional-images.md): Use the additionalimagesurl field to provide secondary product images from multiple angles.
- [Product API request overview](/catalog/catalog_api/product/request-overview.md): POST /v2/data_ingestion/catalog/product/submission
- [Variant specifications](/catalog/catalog_api/product/variant-specifications.md): Variants of products, such as different sizes, counts, flavors, and colors, help customers easily compare different versions of the same product. Use the variant field to group versions of the same product. For example, diapers can be available in different sizes and counts.
- [test](/catalog/catalog_api/test.md): Placeholder
- [File requirements](/catalog/catalog_inventory_file/file_specifications/file-requirements.md): The inventory file you create needs to meet certain requirements.
- [File types](/catalog/catalog_inventory_file/file_specifications/file-types.md): You can use three types of inventory files to maintain your catalog. Depending on your purpose, you can choose the file type to use.
- [File specifications](/catalog/catalog_inventory_file/file_specifications/overview.md): To add products to your storefront, create an inventory file. An inventory file is a spreadsheet containing your inventory data. Use your preferred editor to create a spreadsheet containing the inventory data.
- [Catalog inventory file](/catalog/catalog_inventory_file/overview.md): A catalog inventory file is a spreadsheet containing your inventory data. Use inventory files to manage your product catalog, sales, and promotions. The following sections guide you through the process of creating your inventory files.
- [Common promotion errors](/catalog/catalog_inventory_file/sale_and_promotion/common-promotion-errors.md): With all the different ways you can offer discounts, ensure that every promotion and sale makes sense. Here are some common mistakes to avoid.
- [Loyalty requirements](/catalog/catalog_inventory_file/sale_and_promotion/loyalty-requirements.md): To offer discounts to loyalty members only, add the following columns. If a product is on sale and has loyalty pricing, a loyalty member receives the lowest price between the sale price and the loyalty price. You control these values through your inventory file.
- [Manage active promotions](/catalog/catalog_inventory_file/sale_and_promotion/manage-active-promotions.md): This topic applies to retailers on Storefront Pro 4.x.
- [Sales and promotions](/catalog/catalog_inventory_file/sale_and_promotion/overview.md): Offer customers discounts by using any of the following methods:
- [Promotion metadata fields](/catalog/catalog_inventory_file/sale_and_promotion/promotion-metadata-fields.md): The promotion metadata fields determine the promotion details, such as the promotion type, the quantity required to be eligible for the discount, and the discount value.
- [Promotion requirements](/catalog/catalog_inventory_file/sale_and_promotion/promotion-requirements.md): You can create complex promotions such as Buy 3 for $10 and Buy any 2 get 20% off, and apply them to your items. You control these values through your inventory file.
- [Sales requirements](/catalog/catalog_inventory_file/sale_and_promotion/sales-requirements.md): To create a sale on a single item, add the following columns. Sales are available to all customers. You control these values through your inventory file.
- [Additional dimensions](/catalog/catalog_inventory_file/specifications/additional-dimensions.md): In addition to the basic size fields described in the minimum catalog requirements, you can add more fields to better describe products. For example, you can add parweight for loose items like apples, or you can add soldweight for big and bulky products.
- [Alcohol requirements](/catalog/catalog_inventory_file/specifications/alcohol-requirements.md): If you include alcohol-related products in your inventory file, even if they are not available on your storefront, you must include the following columns:
- [Availability requirements](/catalog/catalog_inventory_file/specifications/availability-requirements.md): The availability requirement offers you additional ways to manage availability of inventory beyond the standard available column described in minimum catalog requirements.
- [Blackout period requirements](/catalog/catalog_inventory_file/specifications/blackout-period-requirements.md): Blackout periods allow retailers to temporarily disable product availability for a specific interval of time, for example, when the deli is closed.
- [California Prop 65 warning requirements](/catalog/catalog_inventory_file/specifications/ca-prop65-warning-requirements.md): If you are a retailer in the United States and conduct online business in California, you must display warnings as required by Proposition 65, which was approved by California voters in 1986. The resulting California Code 27 CCR § 25600.2 requires businesses to provide warnings to Californians about significant exposures to chemicals that cause cancer, birth defects, or other reproductive harm.
- [Caper attributes](/catalog/catalog_inventory_file/specifications/caper-attributes.md): Use the following columns to configure the Caper Cart experience.
- [Catering requirements](/catalog/catalog_inventory_file/specifications/catering-requirements.md): Catering columns enable you to specify items that are available as a catering option. You control these values through your inventory file.
- [Cannabinoid requirements](/catalog/catalog_inventory_file/specifications/cbd-requirements.md): If you include cannabinoid-containing products in your inventory file, even if they are not available on your storefront, you must include the following columns:
- [Configurable products](/catalog/catalog_inventory_file/specifications/configurable-products.md): Some products have configurations associated with them. For example, customers can add a variety of things to sandwiches, such as lettuce, tomatoes, and onions. To define these configurations, use the configurable_products column.
- [Fulfillment requirements](/catalog/catalog_inventory_file/specifications/fulfillment-requirements.md): Use the following columns to make an item available for a specific fulfillment method. For example, you can set a sofa as available for pickup only. If these columns are not provided, then the item is available for all fulfillment methods that your store supports. You control these values through your inventory file.
- [Image requirements](/catalog/catalog_inventory_file/specifications/image-source-requirements.md): Instacart collects images from multiple sources to ensure comprehensive coverage. For fresh products, we maintain a large database of images for use across all retailer storefronts. Examples include meat, seafood, produce, and bulk foods like nuts and rice. Other images are sourced directly from retailers or third-party content service providers (CSPs).
- [In-store product locations](/catalog/catalog_inventory_file/specifications/in-store-locations.md): To make it easy for shoppers and customers to find items in your store, provide the location details such as aisle, shelf, and department.
- [Locale requirements](/catalog/catalog_inventory_file/specifications/locale-requirements.md): Use the locale column to show product descriptions in English and French languages. For Canadian retailers who conduct business in Quebec, you must display all attributes in both English and French content. You control these values through your inventory file.
- [Minimum catalog requirements](/catalog/catalog_inventory_file/specifications/minimum-catalog-requirements.md): The following columns are required for all products. If you do not provide data in the required columns, your products are not displayed on your storefront.
- [Nutrition info - Multi-block format](/catalog/catalog_inventory_file/specifications/nutrition_info/nutri-info-multi-block.md): You can provide a product's nutritional information using a structured format that specifies data for each nutrient individually.
- [Nutrition information - Single block format](/catalog/catalog_inventory_file/specifications/nutrition_info/nutri-info-single-block.md): You can provide a product's nutritional information using a structured format that specifies data for all nutrients in a single block.
- [Nutrition information requirements](/catalog/catalog_inventory_file/specifications/nutrition_info/overview.md): For most national brand products, Instacart displays nutritional information using data provided by content service providers (CSPs) and our consumer packaged goods (CPG) partners. For other products, such as private label brands, you can provide your own nutritional data using the nutri_info attribute. Work with your Instacart representative to determine whether to send data using the multi-block or single block format.
- [Product specifications](/catalog/catalog_inventory_file/specifications/overview.md): Product specifications are grouped into different categories to help you better understand the columns that you need to include in your inventory file.
- [Product claims](/catalog/catalog_inventory_file/specifications/product-claims.md): Product claims enable you to identify products by wellness tags, ingredients, and other important details. You can provide these values for in-house and private label products. For national brand products, brand owners can update these values through coordination with a content service provider (CSP).
- [Restricted product requirements](/catalog/catalog_inventory_file/specifications/restricted-product-requirements.md): Restricted products are items with legal requirements, such as minimum age and maximum quantity limitations. These requirements vary by region. Your catalog can contain restricted products as long as they are not on the Instacart list of prohibited products.
- [SNAP EBT requirements](/catalog/catalog_inventory_file/specifications/snap-ebt-requirements.md): Instacart enables customers to use SNAP EBT benefits to purchase groceries. If your store supports SNAP, use these columns to determine product eligibility. You control these values through your inventory file.
- [Special integration requirements](/catalog/catalog_inventory_file/specifications/special-integration-requirements.md): Use these columns to add special features to your storefront. You control these values through your inventory file.
- [Tax requirements](/catalog/catalog_inventory_file/specifications/tax-requirements.md): Instacart collects relevant data to help us apply taxes and fees to products. You control these values through your inventory file.
- [Examples](/catalog/catalog_inventory_file/specifications/variant_requirements/examples.md): You can create JSON objects in one or more dimensions.
- [Locale use](/catalog/catalog_inventory_file/specifications/variant_requirements/locale-use.md): If you include data in your inventory file in more than one language, the dimensionname and the variantgroup_info string must be in the same language regardless of the locale.
- [Variants](/catalog/catalog_inventory_file/specifications/variant_requirements/overview.md): Variants allow you to display a single product along with color, size, and other options. For example, a shirt may be available in blue, black, green and brown, and in sizes small through extra large.
- [Variant dimensions](/catalog/catalog_inventory_file/specifications/variant_requirements/variant-dimensions.md): The descriptors give details of the variant dimensions.
- [Variant requirements](/catalog/catalog_inventory_file/specifications/variant_requirements/variant-requirements.md): Use the following columns to define variant products.
- [Changelog](/catalog/changelog.md): The changelog is a chronological record of retailer-facing changes to the catalog inventory file and catalog API.
- [Error and status codes](/catalog/error_and_status_codes.md)
- [Flyer data requirements](/catalog/flyers/flyer-data-requirements.md): In addition to the flyer metadata file, you must provide Instacart with your flyer data, including your print flyer PDFs and data for mapping flyers to stores. You can choose one of two options for sharing flyer data.
- [Metadata file requirements](/catalog/flyers/metadata-requirements.md): The metadata file contains a list of items featured in each store's flyer and the date range when the flyer is displayed on your storefront. This file can also include optional fields for enabling a shoppable flyer experience.
- [Flyers data ingestion](/catalog/flyers/overview.md): A flyer (also known as a grocery flyer or weekly ads) contains the deals that you want to advertise to your customers for a period of time. You can convert your print flyers to digital versions that are displayed on your storefront.
- [Contact support](/catalog/get_started/contact-support.md): For support related to catalog inventory files or catalog APIs, contact the following teams:
- [Logo requirements](/catalog/get_started/logo-requirements.md): To ensure that your logo displays properly on Instacart Marketplace, adhere to Instacart's requirements and guidelines. Your logo appears across various pages, such as the homepage and the store directory page.
- [Onboarding](/catalog/get_started/onboarding.md): Before you can send Instacart your catalog data, you need to complete the following onboarding tasks:
- [Post launch](/catalog/get_started/post-launch.md): After your Instacart store goes live, update your inventory files regularly:
- [Prepare to launch](/catalog/get_started/prepare-launch.md): To set up your initial catalog of products, work with your Instacart representative through the following phases.
- [Product information pipeline](/catalog/get_started/product-info-sources.md): As a retailer, your inventory file provides the foundation of your product catalog. However, Instacart integrates data from other sources to ensure that the product information displayed on your storefront is accurate, consistent, and aligned with regulatory and industry standards. This means that some of the information presented to customers might not match what you provided in your inventory files.
- [SFTP access](/catalog/get_started/sftp_access.md): During onboarding, your Instacart representative gives you access to Instacart's SFTP server. Before you send inventory files to the server, ensure that they meet the file requirements.
- [Item API](/catalog/item-api.md)
- [Product API](/catalog/product-api.md)

## category

- [Dispatch LMD orders](/category/api/fulfillment/lastmile.md)
- [Service options cart](/category/api/fulfillment/list_cart_service_options.md)
- [Order feedback](/category/api/fulfillment/order_feedback.md)
- [Backend calls](/category/api/fulfillment/order_feedback/backend.md)
- [Frontend calls](/category/api/fulfillment/order_feedback/frontend.md)
- [Orders](/category/api/fulfillment/orders.md)
- [Service options preview](/category/api/fulfillment/preview_service_options.md)
- [Stores](/category/api/fulfillment/stores.md)
- [User accounts](/category/api/fulfillment/users.md)
- [Account linking](/category/api/fulfillment/users/account_linking.md)
- [Chat](/category/api/post_checkout/chat.md)
- [Items and replacements](/category/api/post_checkout/order_items.md)
- [Orders](/category/api/post_checkout/orders.md)
- [Pickup](/category/api/post_checkout/pickup.md)
- [Batches](/category/api/sandbox/batches.md)
- [Instacart users](/category/api/sandbox/instacart_users.md)
- [Orders](/category/api/sandbox/orders.md)
- [Shoppers](/category/api/sandbox/shoppers.md)
- [Point of sale transactions](/category/api/transaction/pos.md)
- [Concepts](/category/fulfillment_guide/concepts.md)
- [Compliance](/category/fulfillment_guide/concepts/compliance.md)
- [How to](/category/fulfillment_guide/concepts/how_to.md)
- [Explore user journeys](/category/fulfillment_guide/concepts/user_journeys.md)
- [Tutorials](/category/fulfillment_guide/tutorials.md)
- [Concepts](/category/post-checkout_guide/concepts.md)
- [Concepts](/category/sandbox_guide/concepts.md)
- [How to](/category/sandbox_guide/how_to.md)
- [Tutorials](/category/sandbox_guide/tutorials.md)
- [Concepts](/category/transactions_guide/concepts.md)
- [Tutorials](/category/transactions_guide/tutorials.md)

## connect

- [Instacart Connect APIs](/connect.md): Use Instacart Connect APIs to add Instacart capabilities to your branded e-commerce site. You and your customers benefit from Instacart scheduling, full-service shopping, delivery, pickup, and order tracking. Your developers can integrate the selected capabilities through REST API calls using any language, such as Java or Python. Learn how to implement the APIs with tutorials, how-to guides, and API documentation.
- [Instacart Connect APIs](/connect/api.md): Find all Instacart Connect APIs in the API reference.
- [Generate an access token](/connect/api/access_tokens.md): Returns an access token. The access token must be included in all other requests as a Bearer token for authentication purposes. Before you begin, ensure you have a client ID and secret from Instacart. You need to pass these values in the request.
- [Authenticate API requests](/connect/api/authentication.md): The Connect APIs use OAuth 2.0 to authenticate requests and authorize access to resources. For more information about using your OAuth credentials to access the APIs, see the following topics:
- [Authentication for event callbacks](/connect/api/authentication_webhooks.md)
- [Error and status codes](/connect/api/error_and_status_codes.md): For all responses, Instacart Connect returns a standard HTTP status code.
- [Changelog - Fulfillment](/connect/api/fulfillment/changelog.md): The changelog summarizes the updates and enhancements made to the Instacart Connect Fulfillment API. The most recent changes are listed first.
- [Customer notifications](/connect/api/fulfillment/communications/customer_notifications.md): If your customers opt in for SMS messages, they can receive the following messages during delivery or pickup workflows. If you want to customize the messages for your use cases, contact your Instacart representative.
- [Event callbacks (webhooks)](/connect/api/fulfillment/communications/event_callbacks.md)
- [Cancel an order](/connect/api/fulfillment/delivery/cancel_order.md): Cancels a delivery, pickup, or last mile delivery order.
- [Reserve a time slot for a desired window](/connect/api/fulfillment/delivery/create_desired_window_hold.md): Reserves the selected time slot for a desired window (serviceoptionreference) for the specified user ID. Time slots are reserved for 10 minutes. If the reservation expires before you can create the order, you can attempt to reserve the same time slot. If the time slot still has capacity, the request is successful. For more information about desired windows, see Desired windows.
- [Create a delivery order](/connect/api/fulfillment/delivery/create_order.md): Creates a delivery order for the reserved time slot.
- [Reserve a time slot](/connect/api/fulfillment/delivery/create_service_option_hold.md): Reserves the selected time slot (serviceholdid) for the specified user ID. Time slots are reserved for 10 minutes. If the reservation expires before you can create the order, you can attempt to reserve the same time slot. If the time slot still has capacity, the request is successful. For more information about time slots, see Service options (time slots).
- [Reserve a previewed time slot](/connect/api/fulfillment/delivery/create_service_option_hold_with_cart.md): This endpoint has been deprecated. To reserve a time slot, use the reserve a time slot endpoint instead.
- [Find stores offering delivery](/connect/api/fulfillment/delivery/find_stores.md): Returns an array of stores that offer delivery for the customer's location. The list of stores is sorted by distance, with the store closest to the customer displayed first.
- [Get an order](/connect/api/fulfillment/delivery/get_order.md): Retrieves order details by order ID. Order details include the status, creation time, time slot, and the Items object. For orders that have been fulfilled, the response includes the location of the fulfillment store, how many bags were in the order, and when the customer received their order.
- [Get orders](/connect/api/fulfillment/delivery/get_orders.md): This endpoint has been deprecated.
- [List time slots for delivery](/connect/api/fulfillment/delivery/list_cart_service_options.md): Lists the available delivery service options for the customer's location and cart items. In this context, service options are time slots, such as Within 5 hours or Friday 9am-11am. Availability is based on current and anticipated shopper availability for the relevant store and delivery location.
- [Preview time slots for delivery](/connect/api/fulfillment/delivery/preview_service_options.md): Previews possible service options for delivery fulfillments.
- [Set item replacements](/connect/api/fulfillment/delivery/set_item_replacements.md): For each line item in a delivery or pickup order, you can use this idempotent operation to provide the customer's replacement selections[]. If the requested line item is out of stock or can't be found, these selections[] define the customer's preferred replacement.
- [Update an order](/connect/api/fulfillment/delivery/update_order.md): Updates a delivery or pickup order.
- [Update a tip](/connect/api/fulfillment/delivery/update_tip.md): Updates the amount of the tip for a completed order.
- [Deprecated](/connect/api/fulfillment/deprecated.md): When the Instacart Connect team deprecates endpoints, we announce the deprecation in the changelog and then move the endpoints to this location. Deprecated endpoints remain supported for a minimum of six months but might be removed in the future.
- [Create a last mile delivery order](/connect/api/fulfillment/last_mile/create_order.md): Creates a last mile delivery order for the reserved time slot. If the reservation has expired, Instacart still attempts to book the time slot. If, however, the time slot capacity is filled, your site needs to prompt the customer to select another time slot.
- [Find stores offering last mile delivery](/connect/api/fulfillment/last_mile/find_stores.md): This operation lets you to find stores that offer last mile deliveries (LMD) to the customer’s location. In your request, the location can be represented as geographical coordinates, an address, or simply a postal code.
- [List time slots for last mile delivery](/connect/api/fulfillment/last_mile/list_cart_service_options.md): Lists the available last mile delivery service options for the customer's location and cart details. In this context, service options are time slots, such as Today 4pm-6pm or Friday 9am-11am. Availability is based on current and anticipated shopper availability for the relevant store and delivery location.
- [Preview time slots for last mile delivery](/connect/api/fulfillment/last_mile/preview_service_options.md): Previews possible service options for last mile delivery fulfillments.
- [Stage a last mile delivery order](/connect/api/fulfillment/last_mile/stage_order.md): Marks the order as staged and ready for delivery, which triggers an event to dispatch a shopper to the store location. Send this request when the bags are in a staging area. A shopper picks up the order from the staging area, verifies the bag labels to confirm it is the right order, and delivers it.
- [Update a last mile delivery order](/connect/api/fulfillment/last_mile/update_order.md): Updates a last mile delivery order.
- [Cancel a last mile delivery order](/connect/api/fulfillment/lastmile/cancel_order.md): This endpoint has been replaced by the same Cancel an order endpoint that is used for delivery and pickup orders. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the shared endpoint.
- [Cancel a dispatch last mile delivery order](/connect/api/fulfillment/lastmile/cancel_order_dispatch.md): This endpoint works only with dispatch last mile delivery orders.
- [Create a last mile delivery order](/connect/api/fulfillment/lastmile/create_order.md): This endpoint has been replaced by Create a last mile delivery order. The URI has changed, but the request parameters and responses remain the same. The new URI is consistent in format with the delivery and pickup workflows. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the revised endpoint.
- [Create a dispatch last mile delivery order](/connect/api/fulfillment/lastmile/create_order_single_call.md): Sends a request to create a dispatch last mile delivery order with the desired delivery window.
- [Reserve a time slot for last mile delivery](/connect/api/fulfillment/lastmile/create_service_option_hold.md): This endpoint has been replaced by the same Reserve a time slot endpoint that is used for delivery and pickup orders. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the shared endpoint.
- [Create a user and validate an address](/connect/api/fulfillment/lastmile/create_user_and_validate_address.md): This endpoint has been replaced by Create a Connect user and validate an address. The URI has changed and now includes the user ID as a path parameter instead of as a body parameter. Otherwise, the request parameters and responses remain the same. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the revised endpoint.
- [Find stores offering last mile delivery](/connect/api/fulfillment/lastmile/find_stores.md): For last mile delivery implementations, this endpoint has been replaced by Find stores offering last mile delivery. The URI has changed, but the request parameters and responses remain the same. The new URI is consistent in format with the delivery and pickup workflows. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the revised endpoint.
- [Find stores offering dispatch last mile delivery](/connect/api/fulfillment/lastmile/find_stores_dispatch.md): This operation is only compatible with dispatch last mile delivery (LMD) workflows.
- [Get a last mile delivery order](/connect/api/fulfillment/lastmile/get_order.md): This endpoint has been replaced by the same Get an order endpoint that is used for delivery and pickup orders. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the shared endpoint.
- [Get a dispatch last mile delivery order](/connect/api/fulfillment/lastmile/get_order_dispatch.md): Retrieves dispatch last mile delivery order details by order ID. Order details include the status, creation time, and time slot. For orders that have been fulfilled, the response includes the store location, how many bags were in the order, and when the customer received their order.
- [Last mile delivery overview](/connect/api/fulfillment/lastmile/lastmile_overview.md): The integrated last mile delivery (lastmile) endpoints have been deprecated and replaced with URIs that are consistent in format with the delivery and pickup URIs. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site.
- [List time slots for last mile delivery](/connect/api/fulfillment/lastmile/list_service_options.md): This endpoint has been replaced by List time slots for last mile delivery and Preview time slots for last mile delivery. The new URIs are consistent in format with the delivery and pickup workflows. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, optionally use Preview time slots for last mile delivery to display time slots before a shopper begins shopping. Use List time slots for last mile delivery to retrieve time slots that are available when the customer is checking out.
- [Stage a last mile delivery order](/connect/api/fulfillment/lastmile/stage_order.md): This endpoint has been replaced by Stage a last mile delivery order. The URI has changed, but the request parameters and responses remain the same. The new URI is consistent in format with the delivery and pickup workflows. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the revised endpoint.
- [Stage a dispatch last mile delivery order](/connect/api/fulfillment/lastmile/stage_order_dispatch.md): Marks the dispatch last mile delivery order as staged and ready for delivery, which triggers an event to dispatch a shopper to the store location. Send this request when the bags are in a staging area. A shopper picks up the order from the staging area and delivers it.
- [Update a last mile delivery order](/connect/api/fulfillment/lastmile/update_order.md): This endpoint has been replaced by Update a last mile delivery order. The URI has changed, but the request parameters and responses remain the same. The new URI is consistent in format with the delivery and pickup workflows. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the revised endpoint.
- [Update a dispatch last mile delivery order](/connect/api/fulfillment/lastmile/update_order_dispatch.md): Updates a dispatch last mile delivery order.
- [Validate an address](/connect/api/fulfillment/lastmile/validate_address.md): This endpoint has been replaced by Create a Connect user and validate an address, which checks for the user and, if the user already exists, validates the address. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the revised endpoint.
- [Create or update order feedback (backend)](/connect/api/fulfillment/order_feedback/backend/create_or_update_order_feedback.md): Create or update the feedback for an order.
- [Create or update order feedback (frontend)](/connect/api/fulfillment/order_feedback/frontend/create_or_update_order_feedback.md): Create or update the feedback for an order.
- [Fulfillment API endpoints overview](/connect/api/fulfillment/overview.md): The Fulfillment API contains the following resource endpoints:
- [Create a pickup order](/connect/api/fulfillment/pickup/create_order.md): Creates a pickup order for the reserved time slot. If the reservation has expired, Instacart still attempts to book the time slot. If, however, the time slot capacity is filled, your site needs to prompt the customer to select another time slot.
- [Find stores offering pickup](/connect/api/fulfillment/pickup/find_stores.md): Returns an array of stores that offer pickup for the customer's location. The list of stores is sorted by distance, with the store closest to the customer displayed first.
- [List time slots for pickup](/connect/api/fulfillment/pickup/list_cart_service_options.md): Lists the available pickup service options for the customer's location and cart items. In this context, service options are time slots, such as Within 5 hours or Friday 9am-11am. Availability is based on current and anticipated shopper availability for the relevant store location. The list includes immediate and scheduled time slots.
- [Preview time slots for pickup](/connect/api/fulfillment/pickup/preview_service_options.md): Previews possible service options for pickup fulfillments.
- [Create a Connect user account](/connect/api/fulfillment/users/create_user.md): Creates a Connect user account with the user ID specified in the body of the request. The user ID is defined by your site and can be any unique identifier, such as a login name, loyalty ID, or email address.
- [Create a Connect user and validate an address](/connect/api/fulfillment/users/create_user_and_address.md): Creates a Connect user account and validates the address provided in the request. Use this endpoint for last mile delivery orders or for delivery orders where you want to validate an address early in the flow. The user ID is generated by your site and can be any unique identifier, such as a login name, loyalty ID, or email address. For more information about users, see create a user.
- [Create a user data deletion request](/connect/api/fulfillment/users/create_user_deletion_request.md): Sends a request to Instacart to delete the data for the specified Connect user account in accordance with applicable data privacy laws and regulations. If the request is received, the response contains the success field set to true. After Instacart receives the request, a user privacy workflow is initiated and the Connect user account and any associated user data is deleted.
- [Generate a linking token](/connect/api/fulfillment/users/generate_linking_token.md): Generates a linking token from a valid authorization code. The authorization code comes from Instacart and verifies that the customer has granted your site access to their Instacart account. For more information about the authorization code, see How to link an Instacart account.
- [Get Instacart account information](/connect/api/fulfillment/users/get_user_link.md): Retrieves information about the Instacart account that is linked to the specified Connect user account. The response contains the status of the Instacart+ membership. If true, the response also reports the expiration date of the membership.
- [Link an Instacart account](/connect/api/fulfillment/users/link_user.md): Links a customer's Connect user account to their Instacart account. Requires a valid linking token. After the accounts are linked, you can get Instacart account information.
- [Validate items](/connect/api/fulfillment/validate_items.md): For a given delivery address or pickup store location, this operation validates each provided item against Instacart’s current instance of the store's catalog. Specifically, it checks whether each items] exists and whether its quantity parameter (count or weight) matches the [product-type configuration.
- [Localization](/connect/api/localization.md): Instacart Connect supports the Accept-Language request HTTP header as described in RFC 7231. For example, your requests can specify a list of languages and you can add weights for resolving those languages.
- [Revoke an access token](/connect/api/oauth/revoke_access_token.md): Revokes an access token issued by an OAuth application. In the request body, include the token you want revoked, along with the clientid and clientsecret of the application that issued it.
- [Permissions and scopes](/connect/api/permissions_scopes.md): Your retailer configuration includes the list of APIs and capabilities (collectively called APIs) that your organization has permission to use. When your site generates an access token to authenticate with the Connect platform, you specify which API you want to access by setting the scope. The generated access token is limited to that API. For more information, see Generate an access token.
- [Changelog - Post-checkout](/connect/api/post_checkout/changelog.md): The changelog summarizes the updates and enhancements made to the Instacart Connect Post-checkout API. The most recent changes are listed first. Unless noted, all changes are non-breaking.
- [Get chat messages](/connect/api/post_checkout/chat/get_chat_messages.md): This operation gets all messages exchanged between the customer and shoppers while an order is being fulfilled.
- [Get order messages](/connect/api/post_checkout/chat/get_order_messages.md): This operation gets all of an order’s messages and notifications. This includes the chat messages exchanged between the customer and shoppers, as well as automated order notifications, such as those sent when a shopper replaces an item or completes delivery. The customer-shopper exchanged messages are returned in chatmessages and the status notifications can be found in lifecyclemessages .
- [Mark messages as read](/connect/api/post_checkout/chat/mark_messages_as_read.md): Marks all the non-read messages sent by the shopper.
- [Send a message to the shopper](/connect/api/post_checkout/chat/send_chat_message.md): Sends a message to the shopper associated with the order.
- [Event callback](/connect/api/post_checkout/communications/event_callbacks.md): In addition to the Fulfillment API event callbacks, the Post-checkout API sends a callback to your retailer site when a customer message needs to be sent to the shopper. To enable the callback, contact your Instacart representative.
- [Get order items](/connect/api/post_checkout/order_items/get_order_items.md): Retrieves the list of items in the order. Each item in the list includes item details of the ordered item, the current status of that item, and the current replacement for that item, if one exists. Item details include the name, quantity ordered, and cost unit.
- [Handle order item replacement](/connect/api/post_checkout/order_items/handle_order_item_replacement.md): If an Instacart Shopper app user can’t find an order item but proposes a replacement, this operation lets you inform Instacart whether the customer approves of the proposed item. If the customer rejects the proposal, your request can provide an alternative item, which Instacart prompts the shopper to find instead.
- [Get order handling information](/connect/api/post_checkout/order/get_handling_details.md): Retrieves handling information related to the specified order. This includes the delivery or pickup address, the coordinates of the delivery of pickup address, the information about the current shopper, and any notes or instructions included with the order.
- [Get an order](/connect/api/post_checkout/order/get_order.md): Retrieves high-level information about the specified order. This includes the creation date of the order, the current workflow state, the fulfillment type, and the start and end times of the order's delivery window.
- [Get order location](/connect/api/post_checkout/order/get_order_location.md): Retrieves the current location of an order while the order is being delivered to the customer. The location is returned as geographic coordinates. If you send this request while the order is not in the DELIVERING state, the response is empty.
- [Post-checkout API endpoints overview](/connect/api/post_checkout/overview.md): The Post-checkout API contains the following resource endpoints:
- [Create or update a pickup delegate](/connect/api/post_checkout/pickup/create_update_pickup_delegate.md): Creates or updates a pickup delegate, which represents a person authorized to pick up the order on the customer's behalf.
- [Create or update vehicle information](/connect/api/post_checkout/pickup/create_update_vehicle_info.md): Use this operation during curbside pickups to provide details about the customer's (or the pickup delegate's) vehicle. Instacart passes the details you provide to one or more store associates so that it's easier for the designated runner to identify the vehicle.
- [Get pickup instructions](/connect/api/post_checkout/pickup/get_order_pickup_details.md): Retrieves a set of instructions for customers to follow when picking up their order from a retailer. Instructions can be created for whichever types of pickup the retailer supports: curbside, locker, or in-store. The instructions can include text and optional images.
- [Get vehicle information](/connect/api/post_checkout/pickup/get_vehicle_info.md): Retrieves information about the customer's vehicle. With the make and model, the runner can easily find the vehicle within the store's designated pickup area. With the license plate number, the runner can verify that they have the correct customer before placing the order in the vehicle.
- [Record customer arrival](/connect/api/post_checkout/pickup/record_user_arrival.md): Use this operation to record that the customer (or the customer's delegate) has arrived at the store for a curbside pickup. Instacart then notifies one or more of the store's associates so they know to run the order out to the designated pickup area.
- [Schedule pickup](/connect/api/post_checkout/pickup/schedule_pickup.md): To help reduce the customer’s wait time at the store, you can use this operation to schedule a curbside pickup.
- [Request headers](/connect/api/request_headers.md): HTTP request headers provide contextual information about your API request. Some headers and values are required, while others are optional or required only under certain conditions.
- [Advance the batch status](/connect/api/sandbox/batches/advance_batch_state.md): Advances the status of a batch through the statuses for the selected fulfillment workflow. You specified the fulfillment workflow when you generated the batch with the batch_type attribute set to one of the workflows. The transitions occur in the order shown. Optionally, you can set the status in the request body.
- [Generate a batch](/connect/api/sandbox/batches/generate_batch.md): Generates a batch that contains an order ID and a shopper ID. To create an order ID, use the appropriate Create order_ endpoint in the Fulfillment API.
- [Changelog - Sandbox](/connect/api/sandbox/changelog.md): The changelog summarizes the updates and enhancements made to the Instacart Connect Sandbox API. The most recent changes are listed first.
- [Authorize an Instacart user for account linking](/connect/api/sandbox/instacart_users/authorize_instacart_user.md): Authorizes an Instacart user for account linking.
- [Create an Instacart user](/connect/api/sandbox/instacart_users/create_instacart_user.md): Creates an Instacart user.
- [Simulate an order callback](/connect/api/sandbox/orders/simulate_order_callback.md): Simulate an event callback for some order statuses that are not covered by the batch statuses.
- [Sandbox API endpoints overview](/connect/api/sandbox/overview.md): The Sandbox API contains the following resource endpoints:
- [Create a shopper](/connect/api/sandbox/shoppers/create_shopper.md): Creates a shopper and returns a shopper ID for that shopper.
- [Create an order item as a shopper](/connect/api/sandbox/shoppers/create_shopper_order_item.md): Creates an order item as a shopper.
- [Update an order item as a shopper](/connect/api/sandbox/shoppers/update_shopper_order_item.md): Updates an order item as a shopper.
- [Changelog - Transactions](/connect/api/transaction/changelog.md): The changelog summarizes the updates and enhancements made to the Instacart Connect Transaction API and file upload approach. The most recent changes are listed first. All changes are non-breaking changes.
- [Transaction API endpoints overview](/connect/api/transaction/overview.md): The Transaction API contains the following resource endpoint:
- [Send point of sale transaction information](/connect/api/transaction/send_pos_transaction.md): Sends point of sale (POS) transaction information to Instacart.
- [Instacart Connect Fulfillment API](/connect/fulfillment.md): Offer your customers the convenience of Instacart scheduling, full-service shopping, delivery, pickup, last mile delivery, and dispatch last mile delivery with the Instacart Connect Fulfillment API.
- [Account linking](/connect/fulfillment_guide/concepts/account_linking.md): Account linking allows your customers to link their Instacart account to the Connect user account. When a linked customer signs in to your retailer site, your site can verify their Instacart+ membership status and offer the customer a discounted delivery similar to what they receive when shopping through Instacart Marketplace. You might also want to offer other incentives to these customers to encourage them to shop through your retailer site.
- [Big & bulky](/connect/fulfillment_guide/concepts/big_and_bulky.md): Big and bulky is a fulfillment capability that enables delivery for large items, such as outdoor furniture, home office supplies, appliances, and electronics. With big and bulky, you can offer more of your catalog online and provide your customers a wider assortment of items for delivery. For example, your customers can order and receive their grocery items and household goods alongside their large items.
- [Catalog](/connect/fulfillment_guide/concepts/catalog.md): An accurate retailer catalog is the foundation of a successful full-service fulfillment workflow. When you share your catalog with Instacart, it enables Instacart Connect to include a list of items in the order that goes to the shoppers. If a shopper can't find an item in an order, they can suggest replacement items from your catalog.
- [Certified delivery](/connect/fulfillment_guide/concepts/certified_delivery.md): Certified delivery requires customers to sign for orders before the order is released into their possession. Certified delivery is used for high-value items. This delivery type provides you and your customers the peace of mind that comes with the successful delivery of high-value items.
- [Code verified delivery](/connect/fulfillment_guide/concepts/code_verified_delivery.md): To increase the likelihood that orders reach their intended recipients, the Instacart Shopper app can prompt shoppers to collect a code from customers before handing over a delivery. This code consists of the last four digits of the phone number associated with the order, making it easy for customers to remember while also adding a layer of security.
- [Alcohol compliance](/connect/fulfillment_guide/concepts/compliance/alcohol_compliance.md): The legal requirements for alcohol sales and delivery vary across regions. Retailers and Instacart must ensure that they are in compliance with these laws. Instacart has a compliance service that is used by all Instacart solutions, including Instacart Connect. When a cart or order contains alcohol, the request goes to the compliance service, which identifies the region and runs the compliance check.
- [Data privacy](/connect/fulfillment_guide/concepts/compliance/data_privacy.md): The customer data sent to Instacart Connect is provided by the retailer. Instacart and the retailer form an agreement about how the data can be used by Instacart. For more information, contact your Instacart Connect Account Manager and their legal partner.
- [Over-the-counter medication](/connect/fulfillment_guide/concepts/compliance/over_the_counter_medication.md): Over-the-counter medication can be fulfilled through Instacart Connect provided the medication does not contain a prohibited controlled substance. When an order contains over-the-counter medication, the request must contain the customer's date of birth and not exceed the maximum quantity.
- [Privacy policy and terms of service](/connect/fulfillment_guide/concepts/compliance/privacy_termsofuse.md)
- [Customer communications](/connect/fulfillment_guide/concepts/customer_communications.md): Your customers can receive order status notifications and chat with shoppers via SMS. To add SMS capabilities to an application, you have the following options:
- [Desired windows](/connect/fulfillment_guide/concepts/desired_windows.md): Desired windows represent requested delivery time periods. You provide Instacart one or more desired time slots and a single delivery location, and then the fulfillment engine checks whether capacity exists to fulfill the order.
- [Fulfillment options](/connect/fulfillment_guide/concepts/fulfillment_options.md): Fulfillment options are the methods that you can use to get orders to your customers. The fulfillment options you implement depend on whether your customers want the order delivered or want to pick up the order. The options also depend on whether you want to use your existing picking technology or want a shopper to pick the order using the Instacart Shopper app.
- [Delivery user journey](/connect/fulfillment_guide/concepts/fulfillment/user_journey_delivery.md): Instacart Connect seamlessly powers same-day or scheduled delivery on retailer-owned e-commerce sites. The delivery end-to-end user journey shows an example of a customer using a retailer site to create an order for delivery. The journey includes the customer chatting with a shopper as the order is fulfilled.
- [Dispatch last mile delivery user journey](/connect/fulfillment_guide/concepts/fulfillment/user_journey_dispatch_LMD.md): Instacart Connect seamlessly powers same-day delivery on retailer-owned e-commerce sites. The dispatch last mile delivery end-to-end user journey shows an example of a customer using a retailer site to create an order for dispatch last mile delivery. A retailer employee shops the order and stages it for delivery by a shopper.
- [Last mile delivery user journey](/connect/fulfillment_guide/concepts/fulfillment/user_journey_last_mile_delivery.md): Instacart Connect seamlessly powers same-day delivery on retailer-owned e-commerce sites. The last mile delivery end-to-end user journey shows an example of a customer using a retailer site to create an order for last mile delivery. A retailer employee shops the order and stages it for delivery by a shopper.
- [Pickup user journey](/connect/fulfillment_guide/concepts/fulfillment/user_journey_pickup.md): Instacart Connect seamlessly powers same-day pickup fulfillment on retailer-owned e-commerce sites. The pickup user journey shows an end-to-end example of a customer using a retailer site to create an order for pickup. The journey includes the customer chatting with a shopper as the order is fulfilled.
- [Instacart+ memberships](/connect/fulfillment_guide/concepts/instacartplus_memberships.md): Instacart+ memberships provide customers with benefits, such as free delivery, reduced service fees, and shared family benefits, when they shop through Instacart Marketplace. You can attract these customers to your site by honoring their Instacart+ membership benefits.
- [Order changes](/connect/fulfillment_guide/concepts/lifecycle_changes.md): After an order is created, the order can be updated, rescheduled, or cancelled. The ability to change an order depends on when in the lifecycle the change occurs. The following tables describe which changes are allowed and who can make them.
- [Multi-banner retailers](/connect/fulfillment_guide/concepts/multi-banner_retailer.md): Retailer organizations that operate affiliated stores or subsidiaries under different names, or banners, are referred to as multi-banner retailers. For example, The Garden might fulfill orders under both their grocery chain banner, The Garden Market, and their specialty wine banner, The Garden’s Fine Wines.
- [Order ahead meals](/connect/fulfillment_guide/concepts/order_ahead_meals.md): Order ahead meals are foods prepared by retailer employees and require some lead time to prepare. Order ahead meals require coordination between retailers and shoppers to ensure that the food is prepared and then delivered in a timely manner. Timely delivery is an important part of a positive customer experience for order ahead meals.
- [Order feedback](/connect/fulfillment_guide/concepts/order_feedback.md): Your customers can provide feedback about the fulfillment experience. Feedback can be for the entire fulfillment experience or parts of the experience, such as the helpfulness of the shopper chat, the quality of replacement items, and the timeliness of the delivery.
- [Product quantity types](/connect/fulfillment_guide/concepts/product_quantity.md): Each product in the catalog has attributes that indicate how quantities of that product are sold. For example, some products are sold and priced per unit, while others are sold and priced by weight. There are also variable weight products that can be purchased as a unit, but are priced by their weight.
- [Instacart Platform Portal - Connect views](/connect/fulfillment_guide/concepts/rpp_connect_views.md): When you sign up with Instacart, your retail organization receives access to Instacart Platform Portal (also known as Instacart Retailer Platform). Instacart Platform Portal is a secure browser application where you can view and manage catalog items, inventory, orders, and more. You control access to pages based on roles and user groups so that retail employees have access only to the data that they need to do their jobs.
- [Service options](/connect/fulfillment_guide/concepts/service_options.md): In Instacart Connect, service options are time slots. Time slots might start from the time the order is created or they can be scheduled for a future start time. The time slot includes the time for the order to be batched, assigned, shopped, and received by the customer.
- [Personal data protection](/connect/fulfillment_guide/concepts/shopper_information_removal.md)
- [Shopper-provided item details](/connect/fulfillment_guide/concepts/shopper_provided_item_details.md): Shoppers can offer replacement items to customers even when the item is not in the catalog that was shared with Instacart. The shopper enters the item details manually in the Instacart Shopper app. These manually inputted item details appear in shopper-provided item details fields in the delivered callback and get order response.
- [Supplemental Nutrition Assistance Program (SNAP) and Electronic Benefit Transfer (EBT)](/connect/fulfillment_guide/concepts/snap_ebt.md): The Supplemental Nutrition Assistance Program (SNAP) is a United States federal program that provides nutrition benefits to low-income individuals and families that are used at stores to purchase food. SNAP benefits are processed through the Electronic Benefit Transfer (EBT) debit card system. Shoppers can fulfill orders that are fully or partially paid with SNAP EBT cards.
- [Testing](/connect/fulfillment_guide/concepts/testing.md): Test your fulfillment workflows in a development environment to verify the workflows before moving to a production environment. You can test fulfillment workflows by simulating order status changes. Use the Sandbox API or the Fulfillment Testing Center to test workflows.
- [Frequently asked questions](/connect/fulfillment_guide/faq.md): You might find answers to some of your questions here. If not, contact your Instacart representative.
- [How to asynchronously create a last mile delivery order](/connect/fulfillment_guide/how_to/create_async_lmd_orders.md): Learn how to asynchronously create a last mile delivery order. Asynchronous order creation enables you to reduce API response times and quickly move your customers through the checkout process.
- [How to link a user account with an Instacart account](/connect/fulfillment_guide/how_to/link_an_instacart_account.md): Learn how to link a Connect user account with an Instacart account. For background information, example user journeys, and concept diagrams, see Account linking.
- [How to retrieve time slots for desired windows](/connect/fulfillment_guide/how_to/retrieve_desired_windows.md): By default, when you request a list of time slots for a delivery order, Instacart returns available delivery service options. If you’d like more flexibility with your time slots, when you request a list of time slots for a delivery order, you can also send Instacart your desired windows. For more information, see Desired windows.
- [How to retrieve ETA time slots](/connect/fulfillment_guide/how_to/retrieve_eta_time_slots.md): When listing the delivery time slots for your customers to reserve, you can choose to present estimated time of arrival (ETA) time slots. The ETA service options replace the immediate time slots of within 2 or 5 hours. For more information, see Service options.
- [How to support guest customers](/connect/fulfillment_guide/how_to/support_guest_customers.md): When your retailer site permits shoppers to shop as a guest, you might not want to engage with Instacart Connect until the guest is ready to check out.
- [How to support time-sensitive last mile delivery](/connect/fulfillment_guide/how_to/support_time_sensitive_last_mile_delivery.md): Time-sensitive last mile delivery orders, such as order ahead meals, require careful coordination between retailers and shoppers. To ensure the shopper arrives as close as possible to the time the meal is prepared, Instacart calculates the handoff time. The handoff time is the time when a shopper is expected to reach the food counter.
- [How to verify Instacart+ membership and orders](/connect/fulfillment_guide/how_to/verify_instacartplus_membership.md): Learn how to verify the Instacart+ membership status of a customer and identify Instacart+ orders.
- [Get a client credentials access token for the Fulfillment API](/connect/fulfillment_guide/tutorials/get_started.md): Learn how to authenticate with Instacart Connect and make your first Fulfillment API call in a development environment.
- [Implement delivery with an integrated shopper experience](/connect/fulfillment_guide/tutorials/implement_delivery.md): Learn how to implement a basic delivery workflow that supports having an in-store shopper who uses the Instacart Shopper app. You can try out this tutorial in your development environment.
- [Implement dispatch last mile delivery](/connect/fulfillment_guide/tutorials/implement_dispatch_LMD.md): Learn how to implement a dispatch last mile delivery workflow. You can try out this tutorial in your development environment.
- [Implement last mile delivery](/connect/fulfillment_guide/tutorials/implement_last_mile.md): Learn how to implement a last mile delivery workflow. You can try out this tutorial in your development environment.
- [Implement last mile delivery](/connect/fulfillment_guide/tutorials/implement_last_mile_delivery.md): The integrated last mile delivery (lastmile) endpoints have been deprecated and replaced with URIs that are consistent in format with the delivery and pickup URIs. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your e-commerce site.
- [Implement pickup with an integrated shopper experience](/connect/fulfillment_guide/tutorials/implement_pickup.md): Learn how to implement a basic pickup workflow that supports having an in-store shopper who uses the Instacart Shopper app. You can try out this tutorial in your development environment.
- [Get started](/connect/get_started.md): Learn the basics of building an Instacart Connect API integration. At any time, if you have questions or run into problems, you can contact Instacart Enterprise Technical Support.
- [Instacart Connect Post-checkout API](/connect/post-checkout.md): Offer your customers an order status page where they can interact with shoppers and track their orders. Use the Instacart page or build your own page and use the Instacart Connect Post-checkout API to retrieve order data from Instacart.
- [Certified delivery flow](/connect/post-checkout_guide/concepts/certified_delivery_flow.md): When orders contain high-value items, customers must sign for the order before they can take possession of the items. The certified delivery confirmation page enables your customers to confirm the high-value items and then sign for the order. For more information, see Certified Delivery.
- [Chat](/connect/post-checkout_guide/concepts/chat.md): Shoppers and customers can exchange messages while the shopper is picking items. The shopper uses the Instacart Shopper app as usual. The customer uses the Order Status page from their browser or mobile device.
- [Order Status page](/connect/post-checkout_guide/concepts/order_status_page.md): The Order Status page is a web page where your customers can see real-time updates while their orders are being fulfilled. The page shows the list of items in the order, a map, the shopper's name, and other delivery details.
- [Pickup delegate](/connect/post-checkout_guide/concepts/pickup_delegate.md): The pickup delegate feature lets customers authorize another person to pick up an order on their behalf. Instacart sends messages via SMS to delegates that inform them they've been authorized and provide order status updates. After delegates arrive at the fulfillment store, Instacart also shares their name with store associates via the Instacart Shopper app.
- [Pickup flow](/connect/post-checkout_guide/concepts/pickup_flow.md): When an order is ready for the customer to pick up, the retailer notifies the customer and provides a link to a Ready to pickup page. The Ready to pickup page includes the order status, list of times, pickup time slot, store address, and a link to the pickup instructions. For a curbside pickup, the page might also include a link to a vehicle information page and a way for the customer to indicate that they are at the store.
- [Replacements flow](/connect/post-checkout_guide/concepts/replacement_flow.md): Good item replacements are an important part of the customer shopping experience. With the Order Status page, the shopper can suggest a replacement item and the customer can approve the suggestion or ask for a refund. The customer can review changes from the Shopping in progress or the Review replacements status.
- [Personal data protection](/connect/post-checkout_guide/concepts/shopper_information_removal.md)
- [Get a user access token for the Post-checkout API](/connect/post-checkout_guide/tutorials/get_an_access_token.md): Learn how to get an access token to use with the Post-checkout API endpoints. To generate the access token, first encode the user ID and then include it as an assertion.
- [Implement shopper-customer chat](/connect/post-checkout_guide/tutorials/implement_chat.md): Learn how to populate a chat window on a retailer-designed order status page. Use a polling strategy to retrieve messages from the shopper while shopping is in progress. You will also try sending a customer message to the shopper and marking messages as read.
- [Implement the order status flow](/connect/post-checkout_guide/tutorials/implement_order_status.md): Learn how to get order details to display on a retailer-designed order status page. Use a polling strategy to retrieve the order workflow state and item status as shopping progresses.
- [Implement a pickup experience](/connect/post-checkout_guide/tutorials/implement_pickup_experience.md): Learn how to implement the Post-checkout API pickup experience on a retailer-designed order status page. The pickup experience starts when a pickup order transitions to the workflow state readyforpickup and ends when the customer picks up the order.
- [Implement the item replacement flow](/connect/post-checkout_guide/tutorials/implement_replacements.md): Learn how to capture the customer's response to replacement items. For example, on your order status page, you might have a Review replacements page where a customer can review replacement items and approve or reject them.
- [Post-checkout API tutorials overview](/connect/post-checkout_guide/tutorials/tutorials_overview.md): If your team decides to build and host your own order status page, use the Post-checkout API endpoints to get the order data to display to customers.
- [Instacart Connect Sandbox API](/connect/sandbox.md): Simulate order status changes and callbacks while testing your integration.
- [Delivery testing flow](/connect/sandbox_guide/concepts/delivery_testing.md): The following diagram shows the paths you can follow to achieve your testing goals. For step-by-step instructions, see Test delivery.
- [Last mile delivery testing flow](/connect/sandbox_guide/concepts/last_mile_delivery_testing.md): The following diagram shows the paths you can follow to achieve your testing goals. For step-by-step instructions, see Test last mile delivery.
- [Pickup testing flow](/connect/sandbox_guide/concepts/pickup_testing.md): The following diagram shows the paths you can follow to achieve your testing goals. For step-by-step instructions, see Test pickup.
- [The Shopper app and the Sandbox API](/connect/sandbox_guide/concepts/shopper_app.md): You can simulate a shopper’s behavior with the Sandbox API. For the delivery and pickup workflows, you can simulate the shopper picking items from the shelf.
- [Simulate callbacks](/connect/sandbox_guide/how_to/simulate_callbacks.md): You can test the order status callbacks that are not available through the basic workflows. When you set the status, it simulates a callback to your callback endpoint. For more information, see the Simulate order callback endpoint.
- [Test account linking](/connect/sandbox_guide/how_to/test_account_linking.md): You can simulate creating an Instacart user and then linking a user account with an Instacart account.
- [Test item additions by a shopper](/connect/sandbox_guide/how_to/test_item_additions.md): Simulate a shopper being asked by the customer to add an item to the order.
- [Test item updates by a shopper](/connect/sandbox_guide/how_to/test_item_updates.md): You can simulate a shopper finding items, replacing items, and refunding items. You can also change the item quantity.
- [Get started with testing](/connect/sandbox_guide/tutorials/get_a_token.md): To make requests to the Sandbox API, you need a bearer token with the client_credentials grant type. To generate the token, use the authentication endpoint and specify your client ID and secret in the body.
- [Test delivery](/connect/sandbox_guide/tutorials/test_delivery.md): Test the delivery workflow from order creation through delivery. Use the Sandbox API endpoints to simulate the actions of a shopper and the related changes in order status in the Instacart system.
- [Test last mile delivery](/connect/sandbox_guide/tutorials/test_last_mile_delivery.md): Test the last mile delivery workflow from order creation through delivery. Use the Sandbox API endpoints to simulate the actions of a shopper and the related changes in order status in the Instacart system.
- [Test pickup](/connect/sandbox_guide/tutorials/test_pickup.md): Test the pickup workflow from order creation through to the customer picking up the order. Use the Sandbox API endpoints to simulate the actions of a shopper and the related changes in order status in the Instacart system.
- [Instacart Connect Transactions](/connect/transactions.md): Send your point of sale transaction information to Instacart to ensure the accuracy of financial records.
- [Reconciliation](/connect/transactions_guide/concepts/reconciliation.md): Reconciliation is the process of comparing the two distinct transactions for an order to check that the data match. Retailers can send their point of sale (POS) transaction information to Instacart. Instacart uses POS transaction information to match the POS transactions against online transactions and identify mismatches. If there are mismatches, Instacart adjusts the customer invoice.
- [Get a client credentials access token for the Transaction API](/connect/transactions_guide/tutorials/get_a_client_access_token.md): Learn how to authenticate with Instacart Connect so that you can use the Transaction API.
- [Upload files with transaction information](/connect/transactions_guide/tutorials/send_via_file_upload.md): Learn how to prepare your point of sale (POS) transaction information in a CSV or TXT file and then upload the file to Instacart.
- [Send transaction information with the Transaction API](/connect/transactions_guide/tutorials/send_via_transaction_api.md): Learn how to use the Transaction API to send point of sale transaction information to Instacart. For more information, see Transaction API.

## data_hub

- [Instacart Data Hub](/data_hub.md): The Instacart Data Hub is a clean room environment built on Snowflake, enabling data collaboration with partners through Snowflake's secure clean room infrastructure.
- [Changelog](/data_hub/changelog.md): The changelog is a chronological record of partner-facing changes to the Instacart Data Hub.
- [Configure and view clean rooms](/data_hub/cleanroom.md): A clean room is a data listing that features datasets and queries where partners are restricted on what they can run. For example, use a clean room when you want to run an analysis on the intersection of hashed user emails between two companies, but you don’t want to expose your full dataset.
- [Get started](/data_hub/get_started.md): Instacart requires SHA256 for all personally identifiable information (PII) columns.
- [Key concepts](/data_hub/key_concepts.md): Before you get started, review the following key concepts.
- [Privacy protection](/data_hub/privacy_protection.md): Privacy safeguards have been implemented across all Instacart Data Hub analytics.
- [Activation Overlap Analysis](/data_hub/templates/activation_templates/activation_overlap.md): The Activation Overlap Analysis template creates an audience based on the matched overlap (intersection) of an Instacart table and a partner-provided table.
- [Activation templates](/data_hub/templates/activation_templates/overview.md): Activation templates allow partners to use clean room analysis results to create audience segments for advertising on platforms like social media, programmatic ads, and streaming services.
- [Ads Taxonomy](/data_hub/templates/insights_templates/ads_taxonomy.md): The Ads Taxonomy template provides a table that shows available brands, departments, and categories, including their product counts. Running this template can help you make informed decisions about which brands and categories to include in your downstream analysis.
- [Lifetime Value (LTV)](/data_hub/templates/insights_templates/LTV.md): The Lifetime Value (LTV) template measures how much customers spend over time for specific brands or categories within a set time period. This helps partners understand the long-term value of customers who buy their products on Instacart.
- [New to Brand](/data_hub/templates/insights_templates/new_to_brand.md): The New to Brand template tracks how many new customers versus returning customers a brand gets during specific time periods. This helps partners see how effective their customer acquisition efforts are and evaluate the impact of marketing campaigns on brand growth.
- [Overlap Analysis](/data_hub/templates/insights_templates/overlap_analysis.md): The Overlap Analysis template shows how partner customer data overlaps with Instacart's user base. It helps partners see their potential reach on Instacart by matching hashed identifiers.
- [Insights templates](/data_hub/templates/insights_templates/overview.md): The following Insights templates are available for analysis:
- [Path to Purchase](/data_hub/templates/insights_templates/path_to_purchase.md): The Path to Purchase template analyzes which advertising campaigns customers interacted with before making a purchase. This helps partners understand how different ad formats and campaigns influence buying decisions and optimize their media investment strategies.
- [Purchase Frequency](/data_hub/templates/insights_templates/purchase_frequency.md): The Purchase Frequency template analyzes how often customers make purchases within specified time periods. This helps partners understand customer engagement patterns and purchase behaviors over time.
- [Templates](/data_hub/templates/overview.md): The Instacart Data Hub provides ready-to-use query templates to help partners analyze shared datasets without providing access to raw data in the clean room environment.
- [Troubleshooting](/data_hub/troubleshooting.md): Common issues

## developer_platform_api

- [Introduction](/developer_platform_api.md): Use the public Instacart APIs to add Instacart shopping capabilities to your applications, such as product shopping lists and recipe ingredients.
- [Changelog](/developer_platform_api/api/changelog.md): This changelog summarizes the updates and enhancements made to the Instacart Developer Platform. The most recent changes are listed first. All changes are non-breaking changes.
- [Error and status codes](/developer_platform_api/api/error_and_status_codes.md)
- [API security](/developer_platform_api/api/key-rotation.md): For security best practices, rotate your API keys regularly:
- [API reference overview](/developer_platform_api/api/overview.md): You can use the Instacart Developer Platform API to add Instacart shopping capabilities to your website or app. The REST-based API uses predictable, resource-oriented URLs, and standard HTTP methods, response codes, and authentication.
- [Create recipe page](/developer_platform_api/api/products/create_recipe_page.md): Creates a recipe page on Instacart Marketplace and generates a link to the page. When a user of your site or app clicks the generated link, the page opens and the user can select a store, add ingredients as products to a cart, and check out.
- [Create shopping list page](/developer_platform_api/api/products/create_shopping_list_page.md): Creates a shopping list page on Instacart Marketplace and generates a shareable link. When users click the link, they can select a store, add products to their cart, and check out.
- [Get nearby retailers](/developer_platform_api/api/retailers/get_nearby_retailers.md): Get a list of nearby retailers based on the specified postal code and country code.
- [Units of measurement](/developer_platform_api/api/units_of_measurement.md): The following tables list typical units of measurement to use when specifying ingredients or items for a recipe page or a shopping list page.
- [Badge test](/developer_platform_api/badge.md): This page is meant to test the implementation of badges and should not be a production site.
- [Errors](/developer_platform_api/errors.md): Troubleshooting common errors
- [Frequently asked questions](/developer_platform_api/faq.md): You might find answers to some of your questions here. If not, contact your Instacart representative.
- [Get an API key](/developer_platform_api/get_started/api-keys.md): API keys are used to authenticate your requests to the Instacart Developer Platform. This guide covers how to create, manage, and secure your API keys.
- [Get started](/developer_platform_api/get_started/overview.md): Welcome to the Instacart Developer Platform! This section will help you get started with integrating Instacart's services into your application.
- [Create a recipe page](/developer_platform_api/get_started/recipe.md): Learn how to create a recipe page with Instacart Developer Platform API.
- [CTA design](/developer_platform_api/guide/concepts/design/cta_design.md): Before implementing a Call to Action (CTA) on your website or application, we recommend reviewing Instacart's button design guidelines.
- [CTA placement](/developer_platform_api/guide/concepts/design/cta_placement.md): When determining the position of your Call to Action (CTA), we recommend the following:
- [Instacart logos](/developer_platform_api/guide/concepts/design/logos.md): When creating a Call to Action (CTA), you should use the most recent Instacart logos.
- [Overview](/developer_platform_api/guide/concepts/design/overview.md): The Instacart Developer Platform provides the ability to insert a Call to Action (CTA) directly into your app or website. CTA should allow for easy, functional ordering of recipes. If there are other functions related to the recipe, the Instacart CTA should be placed alongside them.
- [Approval process](/developer_platform_api/guide/concepts/launch_activities/approval_process.md): After testing your integration in development and verifying it meets the pre-launch checklist requirements, create a Production API key. This action triggers a review of your integrated app or website. You receive an email with the result of the review.
- [Conversion tracking and affiliate payments](/developer_platform_api/guide/concepts/launch_activities/conversions_and_payments.md): Instacart Developer Platform partners can apply to join our affiliate program through Impact, which tracks your conversions and pays commissions for the orders attributed to your integration. Sign-up links and program terms and conditions will be shared via email to active partners.
- [Overview of launch activities](/developer_platform_api/guide/concepts/launch_activities/overview.md): To prepare for your launch, complete the following activities:
- [Pre-launch checklist](/developer_platform_api/guide/concepts/launch_activities/pre-launch_checklist.md): Be sure to review and follow guidelines for creating a Call to Action (CTA) button within your submission.
- [Recipe page](/developer_platform_api/guide/concepts/recipe.md): Instacart Developer Platform enables you to offer your users shoppable recipes that suit their preferred lifestyle or diet. With access to over 100,000 stores, options can be limitless with recipe planning.
- [Shopping list page](/developer_platform_api/guide/concepts/shopping_list.md): Instacart Developer Platform provides unique flexibility in the design of shopping lists. With access to stores in multiple locations across North America, you can build shopping lists that cater to different use cases while avoiding administrative overhead and inventory management.
- [Instacart developer guidelines](/developer_platform_api/guide/terms_and_policies/developer_guidelines.md): As part of our commitment to maintaining a high standard of quality and integrity, we have established these guidelines to outline our expectations for Developers using the Instacart Developer Platform (IDP). By adhering to these guidelines, Developers help ensure a positive and safe experience for all. Failure to comply with these guidelines may result in Instacart revoking a Developer’s access to the IDP.
- [Developer messaging guidelines](/developer_platform_api/guide/terms_and_policies/developer_messaging.md): This document outlines guidelines for developers who have integrated with the Instacart Developer Platform and want to communicate their integration publicly. These guidelines ensure that you maintain consistent messaging, use trademarks properly, and align with Instacart's brand standards.
- [Instacart Developer Platform Terms and Conditions](/developer_platform_api/guide/terms_and_policies/developer_terms.md): Last Updated: July 3, 2024
- [Create a recipe page](/developer_platform_api/guide/tutorials/create_a_recipe_page.md): Learn how to create a recipe page with Instacart Developer Platform API.
- [Filters](/developer_platform_api/guide/tutorials/filters.md): To highlight certain brands or health options in a recipe or shopping list, you can apply brand filters or health filters to some or all items in a request. When a customer navigates to the recipe page or shopping list page, these brands or health options are provided as part of the shopping list. If a brand match is not found at the store, an alternative is provided.
- [Connect your AI agent to Instacart with MCP](/developer_platform_api/guide/tutorials/mcp.md): Learn how to connect your AI agent or LLM to Instacart Developer Platform using the Model Context Protocol (MCP).
- [Test your recipes](/developer_platform_api/guide/tutorials/test_your_recipes.md): To test your app integration with Instacart Developer Platform, simulate the user journey. You can set up a manual QA of your app or create end-to-end test code.

## discounting_platform

- [Discounting Platform overview](/discounting_platform.md): With Instacart, you can incentivize your online customers with familiar discounts and other rewards, including:
- [Coupons types](/discounting_platform/coupons/coupon_types.md): With any of the supported coupon providers, you can offer a variety of coupon types to your customers.
- [Coupons](/discounting_platform/coupons/overview.md): You can integrate with third-party providers to display coupons alongside the offers and special pricing that you create. All third-party coupons must be clipped to be redeemed.
- [How to create offers](/discounting_platform/offers/create_offers.md): You create offers either when you define a campaign in Instacart Platform Portal or when you update your catalog inventory file with promotions. You can also have Instacart Marketing Solutions create and run campaigns on your behalf.
- [Offer structure](/discounting_platform/offers/offer_structure.md): An offer is made up of a condition, a reward, and a redemption method. You can also set limitations on offers, such as the number of times an offer can be redeemed. In some cases, you can target offers to a customer segment.
- [Marketplace offer types](/discounting_platform/offers/offer_types_marketplace.md): For Marketplace, Instacart supports simple offer types on baskets through Instacart Platform Portal. Instacart also supports item discount offers through promotions in the catalog inventory file.
- [Storefront offer types](/discounting_platform/offers/offer_types_storefront.md): For Storefront and Storefront Pro, Instacart supports simple and complex offer types on items, collections, and baskets. You can create offers in the Instacart Platform Portal.
- [Offers](/discounting_platform/offers/overview.md): Use offers to create custom incentives. For example, you can create offers tied to buying items or spending a certain amount. You can define a reward that applies to items, the basket, or fees.
- [Special pricing](/discounting_platform/pricing/special_pricing.md): Special pricing (also known as promotional pricing) refers to temporary discounts on item prices within a specified time period. You can make temporary price reductions available to all customers or only to loyalty members. For example, you might create sale pricing on selected products for all customers, or you might discount some or all products for your loyalty members.
- [Changelog](/discounting_platform/releases/changelog.md): The changelog is a chronological record of retailer-facing changes to the unified discounting platform.

## foodstorm

- [Instacart FoodStorm API](/foodstorm.md): For orders that require advance notice and instructions, use the FoodStorm API.
- [Instacart FoodStorm APIs](/foodstorm/api/api_overview.md): Instacart FoodStorm APIs are RESTful. They use predictable, resource-oriented URLs and HTTP response codes. The APIs use built-in HTTP features, such as HTTP authentication and HTTP verbs, which are understood by HTTP clients.
- [Generate an access token](/foodstorm/api/authentication.md): POST https://auth.uat.foodstorm.io/connect/token (UAT)
- [FoodStorm Changelog](/foodstorm/api/changelog.md): The changelog summarizes the updates and enhancements made to Instacart FoodStorm APIs. The most recent changes are listed first. All changes are non-breaking changes.
- [Add an adjustment](/foodstorm/api/items/add_adjustment.md): Records a single, unique point-of-sale (POS) transaction in FoodStorm and adjusts corresponding Quantity Limit totals against menu items in FoodStorm. You can send multiple requests (one transaction per request) at the same time.
- [Create or update items](/foodstorm/api/items/create_item.md): Creates or updates a menu item in the FoodStorm OMS. You must include all item properties and values in the request. After you use this endpoint to create or update an item, all future updates to that item must be done by using this API; you can't use the FoodStorm user interface to update the item.
- [Items API](/foodstorm/api/items/overview.md): You can use the following endpoints to access item attributes and quantities:
- [Update site attributes for items](/foodstorm/api/items/update_item_site_attributes.md): Updates the site/store-level attributes, such as availability and price, for a menu item that exists in the FoodStorm OMS.
- [Adjustments](/foodstorm/foodstorm_guide/concepts/adjustments.md): You can use the API to adjust the item quantities tracked in FoodStorm when items are sold through an external source, such as a point-of-sale (POS) system. Use this API to integrate transactions from your external source with FoodStorm.
- [Items](/foodstorm/foodstorm_guide/concepts/items.md): Menu items are catalog products that you sell through FoodStorm. Use the API to create and update items in the FoodStorm OMS from an external source.
- [Overview](/foodstorm/foodstorm_guide/concepts/overview.md): The concepts in this section are used in the FoodStorm API documentation.
- [Sites](/foodstorm/foodstorm_guide/concepts/sites.md): A site in FoodStorm is a physical store location where you sell your products/menu items. You can use the API to update the following item properties per site: pricing (including tax) and availability.

## glossary

- [Glossary](/glossary.md): The glossary defines terms that are used within Instacart Enterprise product documentation. For general industry terms, use your favorite glossary or use a browser search.

## instacart

- [Instacart Platform Portal Terms of Use](/instacart/ipp-terms.md): Last Updated: April 2, 2025

## mcp_servers

- [Instacart MCP Servers](/mcp_servers.md): Instacart offers a Model Context Protocol (MCP) server that allows AI assistants and other MCP-compatible applications to access Instacart shopping capabilities through a standardized tool interface. The server is designed to support common shopping workflows via natural language in MCP clients.
- [Changelog](/mcp_servers/changelog.md): The changelog is a chronological record of partner-facing changes to Instacart MCP Servers.
- [Get started](/mcp_servers/get-started/get-started-overview.md): If you need help during setup, contact your Instacart representative or create a ticket in the Enterprise Service Desk. For more information about how to create a ticket, see Request technical support.
- [Use Instacart's MCP server](/mcp_servers/get-started/use-instacarts-mcp-server.md): The Instacart Model Context Protocol (MCP) server enables AI assistants and other MCP-compatible applications to access Instacart shopping capabilities. Use the MCP client and natural language to engage in common shopping workflows.

## storefront

- [Storefront and Storefront Pro](/storefront.md): Instacart Storefront is an end-to-end omnichannel digital commerce platform built specifically for grocery. Storefront brings the best of Instacart's technologies to your brand's e-commerce experience.
- [Storefront browser compatibility](/storefront/browser_compatibility.md): Storefront is compatible with the following browser versions:
- [Instacart Platform Portal](/storefront/concepts/instacart_platform_portal.md): Instacart Platform Portal (also known as Instacart Retailer Platform) is your centralized tool for all activities related to your e-commerce sites and storefronts. Use the Portal with all Instacart solutions, including Instacart Storefront sites and your storefront on Instacart Marketplace.
- [Recommendations](/storefront/concepts/recommendations.md): Recommendations are suggestions for complementary items or replacement items. Customers check out their carts and shoppers facilitate item replacements every day. This customer feedback provides a rich understanding of what makes a great replacement or complementary option for an item. The Instacart recommendations service uses machine learning to analyze purchasing patterns across all orders fulfilled by Instacart and to rank items based on popularity and other factors. This data is used to improve the relevancy of recommended items.
- [Set up retailer support](/storefront/concepts/retailer_support.md): This page has moved. You will be redirected.
- [Service options and time slots](/storefront/concepts/service_options_and_time_slots.md): When your customers check out, they are prompted to select a time slot in which to receive their order. The service options you choose to offer determine the types of time slots your customers can select. The available service options are: scheduled, standard ETA, and priority ETA.
- [Business accounts](/storefront/enhance_your_storefront/business_accounts.md): Business accounts enable customers to keep their personal and business orders separate.
- [Campaign links](/storefront/enhance_your_storefront/campaign_links.md)
- [Click-to-redeem offers](/storefront/enhance_your_storefront/click_to_redeem.md): Instacart supports click-to-redeem offers where customers can click a link or scan a QR code to redeem the offer. You can use click-to-redeem offers to drive customers to shop at your storefront on Instacart Marketplace or your e-commerce site. For example, you might offer $10 off their first online order over $35.
- [Content pages](/storefront/enhance_your_storefront/content_pages.md): Content pages provide the flexibility to build pages to suit various business purposes. You can combine shoppable content and static content to help guide your customers through unique experiences. For example, you can design a page to showcase your private label brand, explain your brand ethos, show recipes, or highlight holiday items that customers can easily add to cart. You can also create informational pages, such as an About Us or a Return Policy.
- [Digital coupons page](/storefront/enhance_your_storefront/digital_coupons.md): If you are integrated with third-party loyalty providers, you can add a digital coupons page to your storefront. Customers can browse and discover available coupons before logging in, but must log in or have a loyalty ID associated with their account to clip and redeem coupons.
- [Family accounts](/storefront/enhance_your_storefront/family_accounts.md): Customers can create family accounts, allowing them to invite three additional members to link their accounts and collaboratively contribute to a shared family cart. Also, if one member of the family account has Instacart+, all members can enjoy the Instacart+ benefits when shopping with the family cart.
- [Gifting](/storefront/enhance_your_storefront/gifting.md): The gifting feature enables your customers to send a delivery order as a gift to friends and family. At checkout, customers can view and expand the gifting section to enter the recipient’s name and phone number along with an optional gift message. Customers can also send a digital greeting card with the gift. They can then place the order as a gift. This feature is available for orders that contain alcohol and non-alcohol items.
- [Instacart+](/storefront/enhance_your_storefront/instacart_plus.md): Instacart+ memberships provide customers with benefits when they shop through your storefront, such as $0 delivery fees on orders over $10. Your customers can purchase an Instacart+ membership on your storefront and use their membership benefits on your storefront and on Instacart Marketplace. A free 14-day trial is also available to customers.
- [In-store transactions](/storefront/enhance_your_storefront/instore_transactions.md): Many customers shop in both physical stores and on your e-commerce storefront. If your storefront has a loyalty program, you can upload in-store transaction data so customers can view their in-store purchase history alongside their online orders on the account page.
- [AppCard](/storefront/enhance_your_storefront/loyalty_programs/loyalty_integrators/appcard.md): AppCard is a comprehensive rewards and marketing engine that drives customer loyalty for independent grocers, including many shared Instacart partners. It simplifies customer retention by combining personalization with digital coupons and AI-driven insights. AppCard empowers retailers to segment their customers effectively and deliver targeted, automated campaigns that increase basket size and lifetime value. For more information about segments, see Create a segment.
- [Inmar](/storefront/enhance_your_storefront/loyalty_programs/loyalty_integrators/inmar.md): Inmar helps retailers manage promotions and loyalty rewards. Many retailers that sell through Instacart already use Inmar.
- [Loyalty program providers](/storefront/enhance_your_storefront/loyalty_programs/loyalty_integrators/loyalty_providers.md): For a seamless integration experience, Instacart uses loyalty program providers to synchronize promotions and discounts while linking customer identity data, such as email address and phone number.
- [Supported loyalty integrators](/storefront/enhance_your_storefront/loyalty_programs/loyalty_integrators/overview.md): The following loyalty integrator is currently supported:
- [PassKit integration](/storefront/enhance_your_storefront/loyalty_programs/loyalty_integrators/passkit.md): The PassKit integration lets customers add their loyalty card barcodes directly to their mobile wallets, providing convenient access to their loyalty cards at the store.
- [Loyalty with Storefront](/storefront/enhance_your_storefront/loyalty_programs/loyalty_with_storefront.md): Storefront customers can participate in loyalty programs made available through Instacart. Instacart partners with third-party loyalty providers, such as Inmar and Birdzi, to deliver these programs. You have the flexibility to design a loyalty sign-up process that aligns with your brand’s identity. For more details about how loyalty providers are integrated, see Loyalty program providers.
- [Loyalty with Storefront Pro](/storefront/enhance_your_storefront/loyalty_programs/loyalty_with_storefront_pro.md): Loyalty programs in Storefront Pro allow you to offer coupons, discounts, and loyalty points to your customers. Instacart partners with third-party loyalty program providers, such as Inmar and Birdzi, to deliver these programs. You have the flexibility to design a loyalty sign-up process that aligns with your brand’s identity. For more details about how loyalty program providers are integrated, see Loyalty program providers.
- [Loyalty programs](/storefront/enhance_your_storefront/loyalty_programs/overview.md): You can integrate loyalty programs with Storefront Pro to enhance the customer shopping experience. By implementing loyalty features, you enable shoppers to enjoy benefits such as rewards, membership perks, and personalized savings.
- [Mobile apps](/storefront/enhance_your_storefront/mobile_apps.md): Instacart helps you build and publish a mobile app for your storefront on both Android and iOS platforms.
- [Enhance your storefront](/storefront/enhance_your_storefront/overview.md): Review the optional capabilities and select the ones that support your use cases and requirements. Some capabilities might require an upgrade to Storefront Pro. To enable any of the capabilities, contact your Instacart representative.
- [Recipes](/storefront/enhance_your_storefront/recipes.md): You can display shoppable recipes to help streamline your customers’ meal planning and grocery shopping. Customers can view the details of a recipe to see the ingredients and instructions. They can also add the ingredients to their cart or save the recipe to use in the future.
- [Search engine optimization (SEO)](/storefront/enhance_your_storefront/seo.md): Search engine optimization (SEO) improves a website's visibility and ranking on search engines such as Google, enabling it to reach a larger audience. Search engines process trillions of searches annually, making them a critical tool throughout the entire customer journey. Even if users aren’t explicitly searching for specific retailers, they’re still looking for products or information. This creates opportunities for retailers to appear in search results, engage users, and attract potential customers.
- [SNAP EBT](/storefront/enhance_your_storefront/snap_ebt.md): Example journey
- [Get started](/storefront/get_started.md): The onboarding process differs between Storefront and Storefront Pro. Since Storefront Pro offers a more robust retailer experience, the onboarding process requires more configuration and guidance from Instacart.
- [Retailer structures](/storefront/get_started/retailer_structures.md): To meet the various needs of businesses, Storefront Pro supports diverse retailer structures, from simple models to highly complex setups. These structures are categorized based on the relationships between parent organizations (partners) and their affiliated banners or stores.
- [Get started with Storefront](/storefront/get_started/storefront.md): When you implement Storefront, you get a retailer-branded e-commerce site in the domain of your choice. You can also request retailer-branded apps for iOS and Android.
- [Get started with Storefront Pro](/storefront/get_started/storefront_pro.md): Existing Storefront retailers can upgrade to Storefront Pro at any time. Reach out to your Instacart representative for more information.
- [In-store transactions log](/storefront/integrate_with_your_storefront/instore_transactions_log_inbound.md): If you want to include your in-store sales alongside your e-commerce sales, you can upload in-store transactions logs on a regular basis. For more information about how in-store transactions affect your site, see In-store transactions.
- [Integrate with your storefront](/storefront/integrate_with_your_storefront/overview.md): This section contains specifications for integrating external data and systems with your e-commerce site.
- [Ads](/storefront/learn_about_your_storefront/ads/ads_placement.md): Ads give you instant access to advertising demand from over 1800 national CPG brands. They are designed to be highly relevant and fit seamlessly into your existing content. Ads can generate incremental orders and unlock new shopping journeys without sacrificing the delightful shopping experience your customers are used to.
- [After checkout](/storefront/learn_about_your_storefront/cart_and_checkout/after_checkout.md): After a customer completes the checkout flow, the placed order is batched. The batch contains this order and might contain other orders as well. Shoppers are advised of the batch and can pick up the batch containing the order. The order then goes through the fulfillment process. For more information, see Fulfillment.
- [Cart](/storefront/learn_about_your_storefront/cart_and_checkout/cart.md): Customers build their cart by adding items while browsing and shopping on your storefront.
- [Checkout](/storefront/learn_about_your_storefront/cart_and_checkout/checkout.md): After the customer clicks the Continue to checkout button from the checkout aisle recommendations, the checkout page opens. The customer is prompted for all the information necessary to fulfill the order. The customer can review the order items and totals and then click a button to place their order.
- [Checkout aisle recommendations](/storefront/learn_about_your_storefront/cart_and_checkout/checkout_aisle.md): After a customer clicks the Go to checkout button from the cart, a checkout aisle page opens. Recommended items are presented in collections that are automatically generated. Customers can optionally add items to their cart and then click a button to continue checking out.
- [Cart and checkout overview](/storefront/learn_about_your_storefront/cart_and_checkout/overview.md): As customers shop, their selections are added to their cart. At any time, they can see the total cost of the items they've selected and review the items in the cart. When they are ready to buy the items, they click a button to go to checkout.
- [Pickup order confirmation](/storefront/learn_about_your_storefront/cart_and_checkout/pickup_confirmation.md): After the customer selects replacements, if this is a pickup order, a pickup confirmation page opens. The pickup confirmation includes a map, pickup time slot, store name and address, and pickup instructions.
- [Post-checkout recommendations](/storefront/learn_about_your_storefront/cart_and_checkout/post-checkout_recommendations.md): After the customer selects replacements or confirms a pickup, a post-checkout recommendations page opens. Recommended items are presented in collections that are automatically generated. Customers can optionally add items to their cart and then click Next to finish the checkout process.
- [Replacements](/storefront/learn_about_your_storefront/cart_and_checkout/replacements.md): Customers have the flexibility to choose replacements for low stock items or request a refund if a shopper cannot find the item. Replacement instructions are extremely useful for shoppers and improve customer satisfaction. Customers' replacement items are saved so that they don't have to choose the replacement the next time they buy these items.
- [Customer accounts](/storefront/learn_about_your_storefront/customers/accounts.md): Customers can access their account through the storefront on desktop or mobile apps. They can manage their personal information as well as things like their payment methods and notification settings.
- [Customer data (Storefront Pro)](/storefront/learn_about_your_storefront/customers/data_isolated.md): For Instacart Storefront Pro, your customer data is isolated from Instacart Marketplace customer data and other retailers' customer data. The customer data is logically partitioned by means of a tenant ID. Your site is the only site that can access this data.
- [Customer data (Storefront)](/storefront/learn_about_your_storefront/customers/data_nonisolated.md): For Instacart Storefront, customer accounts are Instacart accounts. The customer uses the same account while shopping across multiple storefronts hosted on either Instacart Marketplace or a retailer-specific Instacart Storefront site.
- [Data privacy compliance (Storefront)](/storefront/learn_about_your_storefront/customers/data_privacy_compliance.md): Instacart must comply with all applicable data privacy laws and regulations. This includes U.S. state privacy laws (“State Privacy Laws”) such as California’s CCPA and CPRA, Virginia’s VCDPA, Colorado’s CPA, Connecticut’s CTDPA, Utah’s UCPA, and a number of other state laws coming into effect in the near future.
- [Data privacy compliance (Storefront Pro)](/storefront/learn_about_your_storefront/customers/data_privacy_compliance_pro.md): Retailers must comply with all applicable data privacy laws and regulations applicable to them. This may include U.S. state privacy laws (“State Privacy Laws”) such as California’s CCPA, Virginia’s VCDPA, Colorado’s CPA, Connecticut’s CTDPA, Utah’s UCPA, and a number of other state laws coming into effect in the near future.
- [Customers](/storefront/learn_about_your_storefront/customers/overview.md): A customer shops on your storefront and creates a customer account to place an order. Customer accounts provide benefits to customers and retailers. Customers gain access to a buy it again list and order history to make shopping faster and easier. Retailers gain access to customer details for those customers who consent to share their information.
- [Frequently asked questions](/storefront/learn_about_your_storefront/faq.md): Find answers to frequently asked questions.
- [Accelerated checkout](/storefront/learn_about_your_storefront/fulfillment/accelerated_checkout.md): When you configure Accelerated checkout with Partner pick, your store associates can skip the traditional checkout process. This process streamlines the picking experience and allows for improved efficiency. You can configure accelerated checkout in one of the following ways:
- [After fulfillment](/storefront/learn_about_your_storefront/fulfillment/after_fulfillment.md): Shortly after the customer receives their order, a reconciliation process runs to ensure that the payment methods are charged correctly for the final order total. They receive their finalized receipt by email. For more information about the reconciliation process that runs, see Payments and reconciliations.
- [Big & bulky](/storefront/learn_about_your_storefront/fulfillment/big_and_bulky.md): Big and bulky is a fulfillment capability that enables delivery for large items, such as outdoor furniture, home office supplies, appliances, and electronics. With big and bulky, you can offer more of your catalog online and provide your customers a wider assortment of items for delivery. For example, your customers can order and receive their grocery items and household goods alongside their large items.
- [Certified delivery](/storefront/learn_about_your_storefront/fulfillment/certified_delivery.md): Certified delivery requires customers to sign for orders before the order is released into their possession. Certified delivery is used for high-value items. This delivery type provides you and your customers the peace of mind that comes with the successful delivery of high-value items.
- [Certified delivery flow](/storefront/learn_about_your_storefront/fulfillment/certified_delivery_flow.md): When orders contain high-value items, customers must sign for the order before they can take possession of the items. The certified delivery confirmation page enables your customers to confirm the high-value items and then sign for the order. For more information, see Certified Delivery.
- [Delivery flow](/storefront/learn_about_your_storefront/fulfillment/delivery_flow.md): When an order is out for delivery, an order status page shows the On the way status. On this page, the customer can see the items in the order, replacements, refunds, shopper name, and delivery address. The map contains a pin for the customer location and, while the shopper is in transit, a pin for the shopper's location.
- [Order status](/storefront/learn_about_your_storefront/fulfillment/order_status.md): Customers can view the progress on their active orders while the orders are being fulfilled. They can track the status of their orders using the order status page or the order status banner on your custom homepage.
- [Order status banner](/storefront/learn_about_your_storefront/fulfillment/order_status_banner.md): The order status banner enables customers to view the status of their active orders on your custom homepage. The banner displays real-time order status updates and shows whether customers can add items to their order. If there are multiple active orders, the order statuses appear stacked vertically. Customers can reschedule the order or use the Add to order experience to add items to their active order.
- [Order status page](/storefront/learn_about_your_storefront/fulfillment/order_status_page.md): An order status page provides live updates to your customers while their orders are being fulfilled. The page contains the list of items, a map, the shopper's name, pickup or delivery details, and a discovery feed with product recommendations.
- [Fulfillment](/storefront/learn_about_your_storefront/fulfillment/overview.md): Your storefront can offer delivery or pickup fulfillment options. Depending on your business needs, the following fulfillment options are available:
- [Partner pick](/storefront/learn_about_your_storefront/fulfillment/partner_pick.md): When you configure partner pick, your store associates can use the Instacart Shopper app to pick orders in the store and prepare them for delivery or pickup. The app provides store associates with tools to view and accept orders, communicate with customers, navigate stores, stage orders, and run pickup orders to customers or Instacart shoppers. Store associates can see an item list for each order, scan items, see customers’ pre-approved substitution preferences, and chat with customers in real time during picking. After an order is picked, they can be staged for either customer pickup or delivery by an Instacart shopper. For pickup, store associates also run the orders to the curbside pickup area to hand off to customers.
- [Pickup flow](/storefront/learn_about_your_storefront/fulfillment/pickup_flow.md): When an order is ready for pick up, an order status page shows the Ready for pickup status. This page includes the order status, list of items, pickup time slot, store address, and a link to the pickup instructions. For curbside pickup orders, customers can provide vehicle details, enable location sharing, and indicate that they are at the store. If location sharing is enabled, the store location will automatically be notified upon the customer’s arrival. Customers can also share their pickup order with a delegate who picks up the order on their behalf.
- [Automated campaigns](/storefront/learn_about_your_storefront/merchandising_opportunities/automated_campaigns.md): Automated campaigns run continuously and target customers at key stages of their shopping journey. Instacart sets up each campaign with recommended offer values and timing, so you can start reaching customers quickly.
- [Campaigns and offers](/storefront/learn_about_your_storefront/merchandising_opportunities/campaigns_and_offers.md): Campaigns are strategic efforts to complete a specific objective. Campaigns can be short-term or long-term initiatives. Use Instacart Platform Portal to design and manage campaigns. You can also save campaigns as drafts and continue to edit them later.
- [Slots and creatives](/storefront/learn_about_your_storefront/merchandising_opportunities/creatives.md): Use slots and creatives to enrich your storefront with custom content, including banners, rich text, and product carousels.
- [Deep linking](/storefront/learn_about_your_storefront/merchandising_opportunities/deep_linking.md): Deep linking improves navigation and ensures users can quickly find the content they need, whether they use the web or the app. Deep links help marketing teams manage campaigns effectively. Marketers can copy URLs and share them directly in campaigns. The links lead users to specific pages without requiring extra setup.
- [Drive awareness campaigns](/storefront/learn_about_your_storefront/merchandising_opportunities/drive_awareness_campaigns.md): Create a non-incentive campaign to raise awareness for various initiatives, such as promotions, contests, and rewards programs. For example, you might want a time-bound campaign to advertise your loyalty rewards program and link out to a rewards registration page.
- [Recommended media dimensions](/storefront/learn_about_your_storefront/merchandising_opportunities/media_dimensions.md): Many creatives support the ability to display media, such as images, animated looped images, or videos.
- [Offer discount campaigns](/storefront/learn_about_your_storefront/merchandising_opportunities/offer_discount_campaigns.md): Create an offer with a user-defined coupon code. You can share the coupon code in another context, like an email blast or a drive awareness campaign.
- [Merchandising opportunities](/storefront/learn_about_your_storefront/merchandising_opportunities/overview.md): Your merchandising team can use the following tools to highlight products and promotions:
- [Promotional banners](/storefront/learn_about_your_storefront/merchandising_opportunities/promotional_banners.md): For storefronts that use the default ML-driven homepage, you can add banners to direct customers to your important campaigns or promotions. The promotional banners appear below the search bar of your storefront. You can display different banners on different devices, such as one banner on your desktop storefront and another on mobile apps.
- [Promotions](/storefront/learn_about_your_storefront/merchandising_opportunities/promotions.md): A promotion (also called an offer or a deal) is a discount on an item or on multiples of an item, such as buy-one-get-one (BOGO) promotions. Promotions are active for the time period that you set. If you have a loyalty program, you can target some promotions to loyalty customers only.
- [Collections](/storefront/learn_about_your_storefront/merchandising_opportunities/retailer_collections.md): Collections are products that are grouped together under a specific theme or category. There are predefined collections and retailer collections.
- [Learn about your storefront](/storefront/learn_about_your_storefront/overview.md): Use this section to learn about the standard storefront capabilities. For information about enhancements to the storefront, see Enhance your storefront.
- [Payments](/storefront/learn_about_your_storefront/payments/overview.md): For all orders, customers must select one core payment method, such as a credit card. They can also select one or more of the alternative payment methods that you choose to offer on your storefront, such as SNAP EBT. The core payment method is used to cover costs that are not covered by the selected alternative payment methods, as well as any additional charges from order modifications. If the alternative payment methods cover the entire order total, however, the core payment method is not charged.
- [Payment methods](/storefront/learn_about_your_storefront/payments/payment_methods.md): You can offer a variety of payment methods on your storefront. The payment methods are set at the retailer level, which means that the same set of payment methods are available in all your store locations.
- [Payments and reconciliations](/storefront/learn_about_your_storefront/payments/payments_and_reconciliations.md): Payment methods can be authorized or charged at the following points in the customer journey: at checkout, during fulfillment, and after fulfillment.
- [Brand and style](/storefront/learn_about_your_storefront/shopping/brand_and_style.md): You can customize the branding and styling for your storefront to reflect your brand and provide a consistent user experience. The brand assets and styles are used throughout your storefront.
- [Buy it again](/storefront/learn_about_your_storefront/shopping/buy_it_again.md): The Buy it again experience highlights a customer's previously purchased items, which makes reordering easy, improves customer retention, and increases cart sizes. These items are highlighted throughout your storefront in the following areas:
- [Item tile](/storefront/learn_about_your_storefront/shopping/catalog/item_tile.md): Item tiles display information about individual products or an assortment of products. Assortments can be a selection of grocery items or a specialty assortment of items for a catering tray or holiday meal. When shopping online, customers want to see enough key details on the item tile to make a purchasing decision quickly. They also want to be able to add a quantity of the item to their cart from the tile. You can configure how much information appears on item tiles in your storefront.
- [Catalog and products](/storefront/learn_about_your_storefront/shopping/catalog/overview.md): A catalog is a library of every possible product that can be sold. Instacart has an extensive Universal Catalog that includes products commonly sold across multiple retailers. For each product, Instacart uses third party sources to obtain the product's attributes at the UPC level. For example, the Universal Catalog includes different brands of milk and their associated attributes, such as images, product description, ingredients, nutritional facts, and storage directions.
- [Product details page](/storefront/learn_about_your_storefront/shopping/catalog/product_details_page.md): Your customers can view all the information about a product on the product details page. Based on the information you provide in the catalog, this page displays additional product information, such as ingredients, nutrition details, and warnings. This page also displays the recommended related products for your customers to view and add to their cart or shopping list. Customers open the product details page by clicking an image in an item tile.
- [Product tags](/storefront/learn_about_your_storefront/shopping/catalog/product_tags.md): Product tags are attributes that can help organize and identify products on your storefront. Tags appear throughout the customer journey as filters on various pages and as labels on item tiles.
- [Products](/storefront/learn_about_your_storefront/shopping/catalog/products.md): A product is something that you can sell. When you add products to your catalog, you want to include product details that can help your customers search and find what they want. Product details include many attributes, such as name, description, image, tags, and price. When customers browse your digital storefront, the products that are available at that store are shown in item tiles.
- [Stock levels](/storefront/learn_about_your_storefront/shopping/catalog/stock_levels.md): The stock level label appears on item tiles to provide customers a general idea of how much inventory is available on the shelves in their selected store. The stock level label is not a guarantee of availability, rather an indicator of the likelihood that a shopper will be able to find the item in store. Instacart uses machine learning to predict how much stock is available based on information collected by shoppers who are in-store shopping for orders, and your catalog data. The predictions can change throughout the day.
- [Custom header](/storefront/learn_about_your_storefront/shopping/custom_header.md): The custom header gives your white label e-commerce site a more distinct and unique style compared to the default header, which is similar to Instacart Marketplace. The custom header supports more links for you to build your ideal customer experience and shopping journeys.
- [Default header](/storefront/learn_about_your_storefront/shopping/default_header.md): The default header is similar to the one on Instacart Marketplace. The following image shows a default header with the available components:
- [Departments](/storefront/learn_about_your_storefront/shopping/departments.md): The department menu displays departments and collections for your customers to browse your store. Departments are folders that help organize your collections.
- [Flyers](/storefront/learn_about_your_storefront/shopping/flyers.md): A flyer (also known as a grocery flyer or weekly ads) contains the deals that you want to advertise to your customers for a period of time. For example, you might advertise weekly or monthly deals. You can create a flyer page in your storefront so that customers can view a digital version of your print flyer and add flyer items to their cart. Customers can view flyers based on their store location.
- [Custom footer](/storefront/learn_about_your_storefront/shopping/footer.md): The custom footer allows you to show additional links to expose information outside of a regular shopping journey, such as your store’s return policy, social media channels, or cookie preferences.
- [Header and footer](/storefront/learn_about_your_storefront/shopping/header.md): The header appears on every page of your storefront and is designed to give customers immediate access to your most popular features, pages, or collections.
- [Homepage](/storefront/learn_about_your_storefront/shopping/homepage.md): The homepage is the first page of your storefront that customers see when they visit your shopping domain.
- [Shopping](/storefront/learn_about_your_storefront/shopping/overview.md): Create a storefront that reflects your brand and catalog. Use this section to understand the core capabilities and the configuration options available to you.
- [Search](/storefront/learn_about_your_storefront/shopping/search/overview.md): Search is the number one channel that customers use to add products to cart, which is why the search experience is a vital part of a successful e-commerce solution. Storefront delivers a high-conversion search experience that drives bigger cart sizes and improves operational efficiencies.
- [Search bar](/storefront/learn_about_your_storefront/shopping/search/search_bar.md): Customers use the search bar to quickly find items that they want to purchase. The search bar includes an autosuggest feature that provides relevant search suggestions to customers after they enter at least three characters.
- [Search results](/storefront/learn_about_your_storefront/shopping/search/search_results.md): The search results layout is divided into primary results and related items sections. The primary results section displays exact matches and strong substitutions, while the related items section displays items and inspirational carousels that are associated with the search query. These carousels, driven by proprietary machine-learning (ML) algorithms, are designed to inspire additional purchases.
- [Search results priority](/storefront/learn_about_your_storefront/shopping/search/search_results_priority.md): With so many different search capabilities, learn about how products are ranked or boosted within the search results.
- [Shopping contexts](/storefront/learn_about_your_storefront/shopping/shopping_contexts.md): The shopping context identifies the customer’s purpose for visiting the site. You can choose to support any of the following shopping contexts.
- [Sort and filter](/storefront/learn_about_your_storefront/shopping/sort_and_filter.md): When searching and browsing your storefront, customers can sort and filter lists of products to find relevant items quicker. The sort and filter experience varies slightly between desktop and mobile devices.
- [Guest user shopping](/storefront/learn_about_your_storefront/sign_on_experience/guest_user.md): Customers can browse your store and add items to their cart without logging in by shopping as a guest. However, they must log in or create an account to check out and complete their purchase.
- [Instacart sign-on](/storefront/learn_about_your_storefront/sign_on_experience/instacart_sign_on.md): By default, your storefront uses the same sign-on service that is used by Instacart Marketplace. Customers log in to your storefront with the same email they use when logging in to Instacart Marketplace. They will receive a one-time-password (OTP) by email, which they must use to authenticate their log in.
- [Sign-on experience](/storefront/learn_about_your_storefront/sign_on_experience/overview.md): The sign-on experience encourages visitors to sign up for an account and log in. In most implementations, visitors are required to log in to continue shopping. The iOS app, however, includes an option for visitors to shop as a guest to comply with Apple App Store Review Guidelines. The guest must log in to a customer account to place an order.
- [Retailer single sign-on](/storefront/learn_about_your_storefront/sign_on_experience/retailer_single_sign_on.md): Single sign-on enables your customers to securely use the same user credentials to log in to all your surfaces, such as your retailer mobile apps, web app, and retailer corporate website. Your Instacart representative works with you to integrate your identity provider with the storefront.
- [Social sign-on](/storefront/learn_about_your_storefront/sign_on_experience/social_sign_on.md): Social sign-on, also known as social login, enables customers to authenticate with your storefront through a social network provider, such as Facebook, Google, or Apple. When a customer uses social sign-on, the storefront sends a request to the social network provider, which attempts to verify the customer's identity or leads a new customer through a registration process. The social network provider returns the results of the authentication to the storefront.
- [Analytics](/storefront/manage_your_storefront/analytics.md): Your storefront captures analytics so that you can track customer traffic and better understand the customer journey. For example, you might want to use analytics to understand the following business insights:
- [Create a customer deletion request](/storefront/manage_your_storefront/compliance_api/create_customer_deletion_request.md): Sends a request to Instacart to delete the data for a Storefront Pro customer in accordance with the California Consumer Privacy Act (CCPA) and other applicable laws. You can identify customers in the request body by specifying a customer's email address, phone number, or other unique identifier.
- [Get a client credentials access token for the Compliance API](/storefront/manage_your_storefront/compliance_api/get_a_client_access_token.md): Learn how to authenticate and make your first Compliance API call.
- [Get a customer deletion status](/storefront/manage_your_storefront/compliance_api/get_customer_deletion_status.md): Validates and retrieves the status of a customer deletion request. You can check whether a deletion request has been processed and find out the current status of the deletion.
- [Compliance API overview](/storefront/manage_your_storefront/compliance_api/overview.md): Retailers on Storefront Pro can use the Compliance API to manage customer data in accordance with applicable privacy laws, such as the California Consumer Privacy Act (CCPA). You can request the deletion of customer data and retrieve the status of deletion requests. When you send a deletion request through the Compliance API, Instacart processes the request and removes the customer's personal data from our systems, ensuring compliance with privacy regulations.
- [Manage your storefront](/storefront/manage_your_storefront/overview.md): After your Instacart Storefront site is launched, you can use the following tools and resources to help you manage the site:
- [Set up Google Analytics 4](/storefront/manage_your_storefront/set_up_analytics.md): Set up Google Analytics 4 (GA4) to track events from your storefront. After you set up a Google Analytics 4 property, you can add the GA4 tag to Instacart’s Google Tag Manager container.
- [2023_06_0 Release Notes](/storefront/releases/2023_06_0_release_notes.md): Release date: June 29, 2023
- [2023_08_0 Release Notes](/storefront/releases/2023_08_0_release_notes.md): Release date: August 28, 2023
- [2023_09_0 Release Notes](/storefront/releases/2023_09_0_release_notes.md): Release date: September 25, 2023
- [2023_11_0 Release Notes](/storefront/releases/2023_11_0_release_notes.md): Release date: November 6, 2023
- [2023_12_0 Release Notes](/storefront/releases/2023_12_0_release_notes.md): Release date: December 18, 2023
- [2024_01_0 Release Notes](/storefront/releases/2024_01_0_release_notes.md): Release date: January 29, 2024
- [2024_02_0 Release Notes](/storefront/releases/2024_02_0_release_notes.md): Release date: February, 20, 2024
- [2024_03_0 Release Notes](/storefront/releases/2024_03_0_release_notes.md): Release date: March 26, 2024
- [2024_04_0 Release Notes](/storefront/releases/2024_04_0_release_notes.md): Release date: April 23, 2024
- [2024_05_0 Release Notes](/storefront/releases/2024_05_0_release_notes.md): Release date: May 21, 2024
- [2024_06_0 Release Notes](/storefront/releases/2024_06_0_release_notes.md): Release date: June 18, 2024
- [2024_07_0 Release Notes](/storefront/releases/2024_07_0_release_notes.md): Release date: July 23, 2024
- [2024_08_0 Release Notes](/storefront/releases/2024_08_0_release_notes.md): Release date: August 20, 2024
- [2024_09_0 Release Notes](/storefront/releases/2024_09_0_release_notes.md): Release date: September 17, 2024
- [2024_10_0 Release Notes](/storefront/releases/2024_10_0_release_notes.md): Release date: October 22, 2024
- [2024_11_0 Release Notes](/storefront/releases/2024_11_0_release_notes.md): Release date: November 19, 2024
- [2024_12_0 Release Notes](/storefront/releases/2024_12_0_release_notes.md): Release date: December 3, 2024
- [2025_01_0 Release Notes](/storefront/releases/2025_01_0_release_notes.md): Release date: January 28, 2025
- [2025_02_0 Release Notes](/storefront/releases/2025_02_0_release_notes.md): Release date: February 25, 2025
- [2025_02_1 Release Notes](/storefront/releases/2025_02_1_release_notes.md): Release date: March 05, 2025
- [2025_03_0 Release Notes](/storefront/releases/2025_03_0_release_notes.md): Release date: March 25, 2025
- [2025_04_0 Release Notes](/storefront/releases/2025_04_0_release_notes.md): Release date: April 29, 2025
- [2025_05_0 Release Notes](/storefront/releases/2025_05_0_release_notes.md): Release date: May 27, 2025
- [2025_06_0 Release Notes](/storefront/releases/2025_06_0_release_notes.md): Release date: June 24, 2025
- [2025_07_0 Release Notes](/storefront/releases/2025_07_0_release_notes.md): Release date: July 29, 2025
- [2025_08_0 Release Notes](/storefront/releases/2025_08_0_release_notes.md): Release date: August 26, 2025
- [2025_09_0 Release Notes](/storefront/releases/2025_09_0_release_notes.md): Release date: September 30, 2025
- [2025_10_0 Release Notes](/storefront/releases/2025_10_0_release_notes.md): Release date: October 28, 2025
- [2025_11_0 Release Notes](/storefront/releases/2025_11_0_release_notes.md): Release date: November 18, 2025
- [2026_01_0 Release Notes](/storefront/releases/2026_01_0_release_notes.md): Release date: January 27, 2026
- [2026_02_0 Release Notes](/storefront/releases/2026_02_0_release_notes.md): Release date: February 24, 2026
- [2026_03_0 Release Notes](/storefront/releases/2026_03_0_release_notes.md): Release date: March 31, 2026
- [2026_04_0 Release Notes](/storefront/releases/2026_04_0_release_notes.md): Release date: April 28, 2026
- [2026_05_0 Release Notes](/storefront/releases/2026_05_0_release_notes.md): Release date: May 26, 2026
- [2026_06_0 Release Notes](/storefront/releases/2026_06_0_release_notes.md): Release date: June 30, 2026
- [Changelog](/storefront/releases/changelog.md): The changelog is a chronological record of retailer-facing changes to Instacart Storefront. Release notes are announced here. Between releases, entries documenting bug fixes, enhancements, and other announcements are added here.
- [Releases](/storefront/releases/overview.md): Releases are available monthly. Between releases, Instacart fixes bugs and enhances the platform as required.
- [Projects](/storefront/releases/projects.md): When there are longer term projects in progress, the status of the projects are available in this section.
- [Release notes](/storefront/releases/release_notes.md): The release notes describe changes to Storefront across releases. These changes can include new features, enhancements, fixes, and removed features. The release notes might also include announcements, deprecation notices, and documentation site updates. In addition to these changes, Instacart continually updates the platform to improve accessibility, performance, and stability and to ensure the best user experience for your customers.
- [Storefront enhancements](/storefront/releases/storefront_enhancements.md): Instacart brings enhancements to the Storefront based on learnings from the Instacart App. The following capabilities are now available in Storefront.

## support

- [Instacart Enterprise Technical Support](/support.md): The Instacart Enterprise Technical Support team supports Instacart's enterprise customers. Enterprise customers are retailers, partners, and advertisers who use Instacart Enterprise technologies in their e-commerce solutions. The Instacart Enterprise Technical Support team handles technical concerns, tasks, questions, and feedback about Instacart Enterprise technologies.
- [Caper support](/support/caper-support.md): Download and print the Caper support info sheet, which provides guidance to store associates seeking help with Caper issues.
- [Answers to typical questions](/support/chatbot_answers.md): What is Instacart Help Center?
- [Communicate maintenance information](/support/communicate_maintenance_info.md): Communicate your maintenance-related information with the Instacart Enterprise Technical Support team so that they are aware of any possible disruptions.
- [Create views](/support/create_views.md): You can create views with filters to see the tickets reported by you or your organization.
- [Find and export tickets](/support/find_and_export_tickets.md): You can find all tickets requested by your team members and use filters to find a subset of tickets. You can also export the list of tickets to a comma-separated values (CSV) file or Excel file.
- [Common fields](/support/help_common_fields.md): These fields appear in the request form for all types of requests.
- [Request types](/support/help_request_types.md): Help us direct your support request to the right team of experts by telling us what type of support you need:
- [Manage tickets](/support/manage_tickets.md): After you submit a request using the Enterprise Service Desk, a ticket is created with your request details. Request tickets are shared with all users of your organization by default.
- [Manage users access to support tools](/support/manage_users.md): You can request to add or remove access for users from your organization to the Enterprise Service Desk and other tools. New users will receive an email invitation to set up their account.
- [Notifications](/support/notifications.md): You are notified about significant events that occur on Enterprise Service Desk tickets.
- [Request technical support](/support/request_technical_support.md): Contact Instacart Enterprise Technical Support by using our Enterprise Service Desk. Follow the online prompts to submit your request.
- [Share tickets](/support/share_tickets.md): Tickets are shared with all users of your organization by default. You can also directly share tickets with specific users to send email notifications about tickets that might need their attention.
- [Subscribe to updates to the status page](/support/subscribe_status_page.md): Subscribe to updates about platform components available to you on the Instacart Enterprise Status page. You can receive notifications by email, text message, or webhook. You can also manage your subscription by choosing which components you want to be notified about or by unsubscribing from all updates.
- [Ticket statuses](/support/track_ticket_status.md): The following diagram shows an example of how a reported issue moves through the statuses:
- [Turn off notifications](/support/turn_off_notifications.md): You can disable notifications on tickets that you no longer want to follow.
- [What's new](/support/whats_new.md): Keep up with changes to our technical support tools and policies.

## widgets

- [Shopping Widgets](/widgets.md): Shopping widgets are front-end web components that you can embed into your retailer site to add e-commerce functionalities powered by Instacart. For example, you can use widgets to enable search results, access cart items, and obtain product collections, without having to interact with any API directly.
- [Changelog](/widgets/changelog.md): This changelog summarizes the updates and enhancements made to the Shopping Widgets. The most recent changes are listed first. Unless otherwise noted, changes are non-breaking changes.
- [Custom events](/widgets/guide/concepts/custom_events.md): Custom events let you track specific interactions on your retailer site. For example, you can use events to measure when a customer checks out their cart, cancels an existing order, or starts a shopping session. You can also integrate custom events into Shopping Widgets to enhance the user's experience. To integrate custom events to your retailer site, contact your Instacart representative.
- [Custom widgets](/widgets/guide/concepts/custom_widgets.md): You can leverage the Instacart Developer Platform Partner API to create custom widgets that address various use cases for your users.
- [Prebuilt widgets](/widgets/guide/concepts/prebuilt_widgets.md): Prebuilt widgets are widgets designed and maintained by Instacart. Use prebuilt widgets to embed e-commerce capabilities to your site.
- [Get started with custom widgets](/widgets/guide/tutorials/get_started_with_custom_widgets.md): Learn how to establish a user session. Custom widgets require a valid user session to authenticate requests to the Instacart Developer Platform. A user session enables Instacart to build a connection between a customer’s shopping interactions on your retailer site and storefront site. For example, if a customer adds items to their cart on your retailer site and then navigates to your storefront site, the cart accurately shows the number of items in their cart on your storefront.
- [Get started with prebuilt widgets](/widgets/guide/tutorials/get_started_with_prebuilt_widgets.md): To get started with the prebuilt widgets, integrate your distribution file and add the widgets library as a script in your framework. Then, you can embed the prebuilt widgets into your site by using the custom HTML elements.
- [Auth and Profile](/widgets/widget_libraries/auth_and_profile.md): The Auth widget enables customers to sign in to their account or register for an account. After customers are authenticated, the Profile widget displays instead. The Profile widget displays a profile menu for customers to view their profile, view the buy it again experience, or log out.
- [Cart](/widgets/widget_libraries/cart.md): The Cart widget displays the number of items in the cart. When a customer clicks the Cart widget, they are navigated to your storefront site. Your storefront site accurately displays the number of items in their cart.
- [Collection](/widgets/widget_libraries/collection.md): The Collection widget displays products in a collection. Customers can add these items to their cart.
- [Search bar](/widgets/widget_libraries/search_bar.md): The Search bar widget displays a search bar for your customers to search for products. When customers enter a search query, they’re navigated to your storefront and shown the search results for their query.