Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion astro.redirects.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,6 @@ export function generateRedirects(basePath) {
'/get-started/run-lighthouse': `${basePath}/get-started/performance`,
'/get-started/overview/': `${basePath}/get-started/`,
'/get-started/seo': `${basePath}/setup/seo/`,
'/get-started/seo/': `${basePath}/setup/seo/`,
'/get-started/dropins-mcp': `${basePath}/ai/dropins-ai-tools`,
'/ai/dropins-mcp': `${basePath}/ai/dropins-ai-tools`,
'/reference/dropins-mcp': `${basePath}/reference/dropins-ai-tools`,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ The endpoints properties define the GraphQL API endpoints for your Commerce back
- **`commerce-core-endpoint`** (read/write) — Core GraphQL endpoint for queries and mutations. This endpoint handles all write operations and some read operations. See <Link href="https://developer.adobe.com/commerce/webapi/reference/graphql/latest/" text="Adobe Commerce GraphQL API" /> for details.

- **`commerce-endpoint`** (read-only) — Services GraphQL endpoint optimized for read-only operations with Catalog Service, Live Search, and Product Recommendations. It is also optimized for performance for product data retrieval. For details, see the following documentation:
- For Adobe Commerce as a Cloud Service, see the <Link href="https://experienceleague.adobe.com/en/docs/commerce/catalog-service/installation#access-the-service" text="Catalog Service Guide" />.
- For Adobe Commerce as a Cloud Service, see the <Link href="https://experienceleague.adobe.com/en/docs/commerce/catalog-service/installation#endpoints" text="Catalog Service Guide" />.
- For Adobe Commerce Optimizer, see the <Link href="https://developer.adobe.com/commerce/services/optimizer/merchandising-services/using-the-api/#base-url" text="Merchandising Services Developer Guide" />.

### Headers
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/commerce-backend/price-book-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ slug: setup/configuration/price-book-setup
import { Steps, Aside } from '@astrojs/starlight/components';
import Link from '@components/Link.astro';

This guide shows you how to enable Adobe Commerce Optimizer Price Book ID functionality in the Adobe Commerce boilerplate. Price Books in Adobe Commerce Optimizer allow you to deliver personalized pricing based on customer segments, contracts, or other business rules. Each <Link href="https://experienceleague.adobe.com/en/docs/commerce/optimizer/setup/pricebooks#view-price-books-in-commerce-optimizer" text="catalog view defines a default Price Book" /> and may restrict which Price Books are allowed for that view. Customers can have their own assigned Price Books, which are used if they fall within the allowed Price Books for the catalog view.
This guide shows you how to enable Adobe Commerce Optimizer Price Book ID functionality in the Adobe Commerce boilerplate. Price Books in Adobe Commerce Optimizer allow you to deliver personalized pricing based on customer segments, contracts, or other business rules. Each <Link href="https://experienceleague.adobe.com/en/docs/commerce/optimizer/setup/pricebooks#view-price-books-in-adobe-commerce-optimizer" text="catalog view defines a default Price Book" /> and may restrict which Price Books are allowed for that view. Customers can have their own assigned Price Books, which are used if they fall within the allowed Price Books for the catalog view.

<Aside type="caution" title="Adobe Commerce Optimizer only">
This guide is specifically for **Adobe Commerce Optimizer** implementations. If you are using Adobe Commerce as a Cloud Service or Adobe Commerce PaaS without Optimizer, this feature does not apply to your setup. Adobe Commerce as a Cloud Service uses customer groups and shared catalogs for pricing instead of Price Book IDs. See the <Link href="/setup/configuration/commerce-configuration/" text="Storefront configuration" /> documentation for configuration options for your Commerce environment.
Expand Down Expand Up @@ -112,7 +112,7 @@ The `eager: true` option ensures the event handler is registered before any auth
</Aside>

<Aside type="note">
Each catalog view in Commerce Optimizer <Link href="https://experienceleague.adobe.com/en/docs/commerce/optimizer/setup/pricebooks#view-price-books-in-commerce-optimizer" text="defines a default Price Book" /> and may restrict which Price Books are allowed. Customers can have their own assigned Price Books. The `commerceOptimizer` GraphQL query returns the appropriate Price Book ID for the authenticated customer, ensuring it falls within the allowed Price Books for the catalog view. For more information about Commerce Optimizer setup, see the <Link href="https://experienceleague.adobe.com/en/docs/commerce/optimizer/setup/catalog-view" text="Catalog view configuration" /> documentation.
Each catalog view in Commerce Optimizer <Link href="https://experienceleague.adobe.com/en/docs/commerce/optimizer/setup/pricebooks#view-price-books-in-adobe-commerce-optimizer" text="defines a default Price Book" /> and may restrict which Price Books are allowed. Customers can have their own assigned Price Books. The `commerceOptimizer` GraphQL query returns the appropriate Price Book ID for the authenticated customer, ensuring it falls within the allowed Price Books for the catalog view. For more information about Commerce Optimizer setup, see the <Link href="https://experienceleague.adobe.com/en/docs/commerce/optimizer/setup/catalog-view" text="Catalog view configuration" /> documentation.
</Aside>

## Additional resources
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,13 +52,13 @@ Supports [Company Management](/dropins-b2b/company-management/) and [Company Swi

Supports the [Requisition List](/dropins-b2b/requisition-list/) drop-in.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/requisition-list/queries/public-requisition-list/"} text={"publicRequisitionList"} /> query — Retrieves a public requisition list by its sharing token without requiring authentication.
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/requisition-list/queries/public-requisition-list"} text={"publicRequisitionList"} /> query — Retrieves a public requisition list by its sharing token without requiring authentication.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/requisition-list/queries/shared-requisition-list/"} text={"sharedRequisitionList"} /> query — Retrieves a read-only shared requisition list for B2B customers, including sender details and associated items, based on the provided token.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/requisition-list/mutations/share-public-requisition-list/"} text={"sharePublicRequisitionList"} /> mutation — Emails an existing public sharing link to one or more recipients.
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/requisition-list/mutations/share-public-requisition-list"} text={"sharePublicRequisitionList"} /> mutation — Emails an existing public sharing link to one or more recipients.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/requisition-list/mutations/add-public-requisition-list-items-to-cart/"} text={"addPublicRequisitionListItemsToCart"} /> mutation — Adds selected items, or all items, from a public requisition list to a customer or guest cart.
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/requisition-list/mutations/add-public-requisition-list-items-to-cart"} text={"addPublicRequisitionListItemsToCart"} /> mutation — Adds selected items, or all items, from a public requisition list to a customer or guest cart.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/requisition-list/mutations/share-requisition-list-by-token/"} text={"shareRequisitionListByToken"} /> mutation — Generates a shareable storefront token that enables B2B customers to share a requisition list with colleagues within the same company.

Expand All @@ -80,15 +80,15 @@ Supports [Quote Management](/dropins-b2b/quote-management/) drop-in.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/"} text={"company"} /> query – Returns a paginated list of company addresses assigned to the company, the company address book configuration settings, and the company's default billing and shipping addresses, if set.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/create-address/"} text={"createCompanyAddress"} /> mutation – Creates a new company address.
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/create-address"} text={"createCompanyAddress"} /> mutation – Creates a new company address.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/delete-address/"} text={"deleteCompanyAddress"} /> mutation – Deletes a company address based on the provided address UID.
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/delete-address"} text={"deleteCompanyAddress"} /> mutation – Deletes a company address based on the provided address UID.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/set-default-address/"} text={"setDefaultCompanyAddress"} /> mutation – Sets a company address as the default billing or shipping address based on the provided address UID.
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/set-default-address"} text={"setDefaultCompanyAddress"} /> mutation – Sets a company address as the default billing or shipping address based on the provided address UID.

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/update-address/"} text={"updateCompanyAddress"} /> mutation – Updates an existing company address based on the provided address UID (address type is immutable after creation).
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/update-address"} text={"updateCompanyAddress"} /> mutation – Updates an existing company address based on the provided address UID (address type is immutable after creation).

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/update-company-config/"} text={"updateCompanyConfig"} /> mutation – Updates company address book settings for the current company.
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/b2b/company/mutations/update-company-config"} text={"updateCompanyConfig"} /> mutation – Updates company address book settings for the current company.


## REST endpoints
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,11 @@ This package provides the following GraphQL queries and mutations:

#### Free Gift Selection

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/cart/mutations/select-free-gift/"} text={"selectFreeGift"} /> mutation — Selects a free gift for an eligible cart promotion.
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/cart/mutations/select-free-gift"} text={"selectFreeGift"} /> mutation — Selects a free gift for an eligible cart promotion.

#### Product Reviews

- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/products/queries/reviews/"} text={"reviews"} /> query — Retrieves approved product reviews for a specified SKU.
- <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/products/queries/reviews"} text={"reviews"} /> query — Retrieves approved product reviews for a specified SKU.

#### Product Alerts

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,10 @@ sidebar:
label: CompanyHierarchy
---

import Link from '@components/Link.astro';

import { Aside } from '@astrojs/starlight/components';
import TableWrapper from '@components/TableWrapper.astro';
import Link from '@components/Link.astro';
import Diagram from '@components/Diagram.astro';

Part of the <Link href="https://github.com/adobe-commerce/storefront-company-management" text="storefront-company-management" /> drop-in. Displays and manages the company organizational hierarchy for company administrators, with an interactive tree view that supports drag-and-drop reorganization of parent-child company relationships. The hierarchy supports only a single-level structure: parent companies and their direct children. Nested hierarchies are not supported.
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/dropins/cart/functions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -269,7 +269,7 @@ Returns `Array<{ code: string; name: string }>`.

## getStoreConfig

The `getStoreConfig` function returns information about a store's configuration. The function calls the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/store-config/" text="storeConfig" /> query.
The `getStoreConfig` function returns information about a store's configuration. The function calls the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/store-config" text="storeConfig" /> query.

```ts
const getStoreConfig = async (): Promise<StoreConfigModel | null>
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/dropins/order/functions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,7 @@ Returns [`OrderDataModel`](#orderdatamodel) or `null`.

## getStoreConfig

The `getStoreConfig` function returns information about the storefront configuration. It is a wrapper for the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/store-config/" text="storeConfig" /> query.
The `getStoreConfig` function returns information about the storefront configuration. It is a wrapper for the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/store-config" text="storeConfig" /> query.

```ts
const getStoreConfig = async (): Promise<StoreConfigModel | null>
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/dropins/user-account/functions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -437,7 +437,7 @@ Returns `RegionTransform[] | []`. See [`RegionTransform`](#regiontransform).

## getStoreConfig

The `getStoreConfig` function calls the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/store-config/" text="storeConfig" /> query to retrieve details about password requirements. The response also includes the seller-assisted buying fields that control whether the feature is active and customize the consent checkbox shown to customers.
The `getStoreConfig` function calls the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/store-config" text="storeConfig" /> query to retrieve details about password requirements. The response also includes the seller-assisted buying fields that control whether the feature is active and customize the consent checkbox shown to customers.

```ts
const getStoreConfig = async (): Promise<StoreConfigModel>
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/dropins/user-auth/functions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -250,7 +250,7 @@ Promise<{

## getStoreConfig

The `getStoreConfig` function calls the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/store-config/" text="storeConfig query" /> to retrieve store configuration data.
The `getStoreConfig` function calls the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/store-config" text="storeConfig query" /> to retrieve store configuration data.

```ts
const getStoreConfig = async (): Promise<StoreConfigModel>
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/dropins/user-auth/recaptcha.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@ reCAPTCHA.setEndpoint('https://www.example.com/graphql');

### setConfig

Fetches the `reCAPTCHA` configuration from Commerce via the <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/recaptcha-form-config/"} text={"recaptchaFormConfig"} /> GraphQL endpoint, then stores the normalized result in `sessionStorage`. The module queries all known form types in a single request and determines the `reCAPTCHA` type (v3 or Enterprise) automatically.
Fetches the `reCAPTCHA` configuration from Commerce via the <Link href={"https://developer.adobe.com/commerce/webapi/graphql/schema/store/queries/recaptcha-form-config"} text={"recaptchaFormConfig"} /> GraphQL endpoint, then stores the normalized result in `sessionStorage`. The module queries all known form types in a single request and determines the `reCAPTCHA` type (v3 or Enterprise) automatically.

**Must be called before `initReCaptcha` and `verifyReCaptcha`.**

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/dropins/wishlist/functions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ Returns [`Wishlist`](#wishlist) or `null`. When targeting a specific list, retur

## createWishlist

The `createWishlist` function creates an additional named wishlist beyond the shopper's default one, using the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/wishlist/mutations/create-wishlist/" text="createWishlist" /> mutation. Use it to provision an extra list that lives alongside the shopper's default wishlist.
The `createWishlist` function creates an additional named wishlist beyond the shopper's default one, using the <Link href="https://developer.adobe.com/commerce/webapi/graphql/schema/wishlist/mutations/create" text="createWishlist" /> mutation. Use it to provision an extra list that lives alongside the shopper's default wishlist.

<Aside type="note">
Multiple wishlists must be enabled for the store. Creating a list fails if it would exceed the configured maximum number of wishlists.
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/how-tos/address-integration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ By the end of this how-to, you'll have:
- Google Places autocomplete wired into the shipping form in `commerce-checkout.js`, triggering suggestions as the shopper types a street address.
- Selected suggestions that automatically fill in the street, city, country, and postal code fields.

You might want to enhance the shopper experience by streamlining the process of populating and verifying the shipping address, thereby reducing the risk of user error. You can achieve this by implementing a third-party address lookup and autocomplete APIs, such as those provided by <Link href={"https://mapsplatform.google.com/maps-products/#places-section"} text={"Google Places"} />.
You might want to enhance the shopper experience by streamlining the process of populating and verifying the shipping address, thereby reducing the risk of user error. You can achieve this by implementing a third-party address lookup and autocomplete APIs, such as those provided by <Link href={"https://mapsplatform.google.com/maps-products/#places"} text={"Google Places"} />.

This how-to describes how to override any field in a checkout address form and extend it to integrate with this service. The implementation supports backend-configurable validation and full form submission integration.

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/how-tos/automatic-category-page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@ Fill the values from the data you fetched in Step 1 — the category's `urlPath`

### Step 3: Create the document in Document Authoring

Post the document to the <Link href="https://opensource.adobe.com/da-admin/" text="Document Authoring Source API" />. The path you post to becomes the document location in your content tree and the page URL — a document at `/foo/apparel.html` is served at `/foo/apparel`.
Post the document to the <Link href="https://docs.da.live/developers/api/source" text="Document Authoring Source API" />. The path you post to becomes the document location in your content tree and the page URL — a document at `/foo/apparel.html` is served at `/foo/apparel`.

```js
const form = new FormData();
Expand Down
Loading
Loading