Issue in ./help/catalog/category-products-sort.md

"You can set up the category options separately for each store to determine the selection of products, their relative position in the list, and the attributes that are available for category rules."

This should be 'Store View' rather than 'store'. We need to be careful when using the word store to mean the generic sense of ecommerce website, as it is easily confused with a Commerce 'Store' which is a configuration entity

Issue in ./help/inventory-management/cli.md

Hey guys I've tried the bin/Adobe Commerce command but it does not work. :)

Issue in ./help/stores-purchase/shipping-in-store-delivery.md

bin/magento inventory-geonames:import UK
Error:-Importing UK: Cannot download country
Expected result: Importing UK: OK

Issue in ./help/merchandising-promotions/google-tag-manager.md

This document references Universal Analytics, whereas all customers are using GA4 now. So it would be very helpful to either update this document (i.e. the GTM Config json file) with GA4 references or provide an additional page that includes that info

On this page(https://experienceleague.adobe.com/docs/commerce-admin/stores-sales/delivery/basic-methods/shipping-table-rate.html#step-1%3A-complete-the-default-settings) at point: 9(Configure the handling fee options according to your requirements.) an example is given for the handling fee calculation based on percent.

For example, if you are charging six percent of the order, enter the value as .06.

But it should be

For example, if you are charging six percent of the order, enter the value as 6.

Note: In Flatrate shipping (https://experienceleague.adobe.com/docs/commerce-admin/stores-sales/delivery/basic-methods/shipping-flat-rate.html?lang=en) correct value is given.

Issue in ./help/b2b/requisition-lists.md

In the last sentence of the first paragraph it states: "It is available for both logged-in users and guests."

I don't think that is true. I don't see any action button/option to add products to requisition list when using the site as a Guest user.

It does show for registered users.

So I think the documentation need to be updated.

Thanks,

Legal address field description is empty on the page https://experienceleague.adobe.com/docs/commerce-admin/b2b/companies/account-company-manage.html?lang=en

Issue in ./help/landing/home.md

Doesn't matter where you are at.

Clicking Save (the bookmark icon) does nothing.

Issue in ./help/configuration-reference/sales/braintree.md
https://experienceleague.adobe.com/docs/commerce-admin/config/sales/payment-methods/braintree.html#local-payment-methods

Compare with https://developer.paypal.com/braintree/docs/guides/local-payment-methods/overview
All non-instant plocal payment methods are missing and two more: Polish BLIK and German Pay upon Invoice.
Furthermore, Direct Debit is not mentioned in the Braintree documentation as a local payment method.

There should be a note to this effect!

Please also do not hesitate to reference Github issues for the implementation of the missing options.

PS: It is unclear to me who is responsible for the Braintree module and its documentation. Braintree support says it’s Adobe.

Issue in ./help/merchandising-promotions/price-rules-cart-free-shipping.md

While this documentation page about free shipping says you should add ‘For shipment with matching items’ value on the ‘Free Shipping’ dropdown, this doesn’t work. Free Shipping is not applied on any order - even when no conditions are set for the promotion.
You have to set the ‘Free Shipping’ dropdown to ‘For matching items only’ value. Then free shipping is applied.

This bug was noted 2 years ago here https://magento.stackexchange.com/questions/331592/magento-2-3-2-free-shipping-cart-rule-not-working

Suggested Update:
from: … ’Set Free Shipping to For shipment with matching items.'
to: … ‘Set Free Shipping to For matching items only.’

There are 2 occurrences of this statement that need changing, and a screencap also.

Additional Notes:
The point of that setting is to designate whether Free Shipping applies only when ALL items in the Cart meet the conditions of the rule, or only when some items meet the rule.

So the conclusion is that OOTB Free Shipping does not work for specific scenarios when you want certain products to enable free shipping and want to allow free shipping on the whole order even if they don’t meet the conditions.

Note that this setting may not even work as intended anyway magento/magento2#14206
magento/magento2#34866

But regardless, the documentation should state a condition that actually works.

Issue in ./help/merchandising-promotions/price-rules-cart-free-shipping.md

Our documentation around Free Shipping setting in Cart Price Rules is a little unclear about the underlying logic of the Free Shipping settings for ‘For Matching Items Only’ and ‘For Shipments with Matching Items’, and when they should be applied, and the relationship to the Free Shipping Method, which is confusing, even after experimenting with the settings.

This post made it clear on the underlying logic.
https://magento.stackexchange.com/questions/332118/magento-2-free-shipping-coupon/332124#332124

Essentially
‘For Matching Items Only’ will remove the products specified in the Actions conditions of a Cart Price Rule from the shipping calculation, but leave any other items in the shipping calculation and a potential shipping fee, and will display as the normally calculated Shipping Method at $0 (if all items match the Action conditions). So its good for targeting free shipping only for specific items in a promotion.

‘For Shipment with Matching Items’ will apply the formal Free Shipping method for the whole cart, even if the cart does not meet the $ threshold specified in the Minimum Order Amount configuration setting, and will display as Free Shipping: $0. So its good for qualifying a whole cart for free shipping when the specified Cart Price Rules are used. But this also requires the Free Shipping method to be active, and set to a high threshold ($99999 etc.) if you don’t have a normal free shipping $ threshold policy in place.

SUGGESTIONS

1. have a general information page about setting free shipping, distinguishing the Free Shipping method, Cart Rules ‘For Matching Items Only’ and Cart Rules ‘For Shipments with Matching Items’, the underlying logic and when they should be applied.

2. update https://experienceleague.adobe.com/docs/commerce-admin/marketing/promotions/cart-rules/price-rules-cart-create.html?lang=en
   The two places where it describes the Free Shipping settings on this page should change
   FROM:
   --
   Free Shipping | Determines if free shipping is included in the promotion, and if so, for which items.
   Options:
   No - Free shipping is not available for the current rule.
   For matching items only - Free shipping is available only for specific items in the cart that match the rule.
   For shipment with matching items - Free shipping is available for all items in the cart. The Free Shipping delivery method must be enabled to use this option.
   --
   TO:
   --
   Free Shipping | Determines if free shipping is included in the promotion, and if so, for which items.
   Options:
   No - Free shipping is not available for the current rule.
   For matching items only - Free shipping is available only for specific items in the cart that match Action conditions specified in the rule - these products are not included in the shipping calculation. All other items that do not match the Action conditions are still included in the shipping calculation and may incur a shipping fee.
   For shipment with matching items - Free shipping is available for all items in the cart, by allowing the application of the formal Free Shipping method, even if the free shipping threshold specified in the Minimum Order Amount configuration setting of the Free Shipping method is not met. The Free Shipping delivery method must be enabled to use this option, and can be set to a very high Minimum Order Amount value (e.g. 999999) if a standard Free Shipping threshold policy is not required.
   --

3. update this page https://experienceleague.adobe.com/docs/commerce-admin/stores-sales/delivery/basic-methods/shipping-free.html?lang=en
   Another info box should be added near the top section (before Step 1):
   "Note. If a Cart Price Rule is active on the current cart with the setting Free Shipping set to ‘For Shipments with Matching Items’, the Free Shipping method will be applied, even if the free shipping threshold specified in the Minimum Order Amount configuration setting of the Free Shipping method is not met. This allows Cart Price Rules to activate the Free Shipping method whenever required on their own specific criteria."

4. Consider revising the Free Shipping Promotion guide https://experienceleague.adobe.com/docs/commerce-admin/marketing/promotions/cart-rules/price-rules-cart-free-shipping.html?lang=en
   It specifies using 'For Matching Items Only' setting (potentially due to earlier feedback I gave), which technically works, and doesn't require configuring the Free Shipping Method, so is a leaner solution, BUT suggesting using it for a general free shipping policy is against the ethos of the setting, which is to target free shipping at SPECIFIC items in a Cart Price Rule, which can then confuse readers. Perhaps an additional method for achieving a free shipping promotion should be written for the same page, using the 'For shipment with matching items' setting and the Free Shipping method, and again highlighting the difference in the underlying logic.

Issue in ./help/customers/audience-activation.md

The link on "create a cart price rule" points to https://experienceleague.adobe.com/en/docs/commerce-admin/marketing/promotions/cart-rules/price-rules-cart-create#set-a-condition-using-real-time-cdp-audiences. However, the structure of the destination page has changed and so has the fragment. The correct destination URL should be https://experienceleague.adobe.com/en/docs/commerce-admin/marketing/promotions/cart-rules/price-rules-cart-create#use-real-time-cdp-audiences-to-set-a-condition.

Issue in ./help/getting-started/adobe-ims-config.md

To configure integrations for an Adobe Enterprise organization or team using the Adobe Developer Console, an Adobe Admin user requires either System Administrator or Developer access to the organization.

The current requirements don't specify this.

From Getting Started in the Adobe Developer Console Guide.

Users who already belong to an Adobe enterprise or team organization, require either System Administrator or Developer permissions in order to access the Adobe Developer Console. More information about user management can be found in the Adobe Admin Console guide.

Incorrect statement in Magento Documentation

"Reorder button is always displayed in the list with Orders (even if all products from the order are not available for reorder)."

Issue in ./help/stores-purchase/reorders-allow.md

https://experienceleague.adobe.com/docs/commerce-admin/stores-sales/shopper-tools/reorders-allow.html?lang=en

Environment:
Adobe Commerce 2.4.5-p2
PHP 8.1

Steps:

1. Order contains two products:

• Lando Gym Jacket S Gray
• Lando Gym Jacket S Green

2. I have disabled Lando Gym Jacket S Green

Expected behavior:
In the list of "My Orders" on the frontend i should see the "Reorder" link next to this order.

Actual behavior:
In the list of "My Orders" on the frontend i don't see the "Reorder" link next to this order.

Issue in ./help/stores-purchase/checkout-instant-purchase.md
This page https://experienceleague-review.com/docs/commerce-merchant-services/payment-services/payments-checkout/vaulting.html is not working
Error message
This site can’t be reachedexperienceleague-review.com unexpectedly closed the connection.
Try:

Checking the connection
Checking the proxy and the firewall
ERR_CONNECTION_CLOSED

Issue in ./help/stores-purchase/tax-class.md

In documentation :

https://experienceleague.adobe.com/en/docs/commerce-admin/stores-sales/site-store/taxes/tax-class

There is written, that shipping tax class can be set on store view level, but this is not truth. In magento 2.4.5p6 this option can be set only on website level. I think this should be editable on store view level, because what in case when we have one website, like Iberia or Scandinavia, and two stores - Spain/Portugal or Sweden/Denmark - then we can only set one percentage for whole website, but the taxes are different on particular store view.

Documentation :

Adobe commerce 2.4.5p6

Issue in ./help/systems/data-import.md

Missing documentation on the new option "Empty attribute value constant" that was added around Magento 2.3.

It should be under "Step 2: Choose the import behavior" in between 5 and 6. You can see the option in the screenshot after 6.

Issue in ./help/getting-started/websites-stores-views.md

Issue in ./help/merchandising-promotions/event-configure.md

'Set up exclusive access' section seems to be a draft of the 'Restrict access' section just below it, so could be deleted?

Change for 'payment' to 'shipping' on the page https://experienceleague.adobe.com/docs/commerce-admin/b2b/companies/account-company-create.html?lang=en

For the Applicable shipping methods field description:
Applicable Shipping Methods
(Admin Only) Indicates the payment methods that are available for company purchases. Options: B2B Shipping Methods / All Enabled Shipping Methods / Selected Shipping Methods

Issue in ./help/stores-purchase/invoices.md

Under "Completed invoice:" title text is shown instead of a screenshot:

![Completed Invoice](./assets/invoice-full.png)<!-- zoom -->

Responsive web design -> CSS in responsive design -> Media queries

https://developer.adobe.com/commerce/frontend-core/guide/responsive-design/css/#media-queries

Third block with code example has a mistake - Omitted parentheses for minimum width expression.

@media only screen and (min-width: @screen__m + 1) and (max-width: (@screen__xl - 1)) {

Issue in ./help/merchandising-promotions/meta-data.md

The screenshot supplied on the page contains a layout that is not actually in the backend. This can be confusing when searching for this section.

Issue in ./help/inventory-management/install-update.md

There is a missing comma on the end of :
"magento/module-inventory-source-selection-api": "*"

Issue in ./help/configuration-reference/advanced/admin.md
https://experienceleague.adobe.com/en/docs/commerce-admin/config/advanced/admin
This URL title show not a proper like instead > it show like >

Issue in ./help/b2b/account-companies.md

The welcome email screenshot is incorrect. The current screenshot is of the Company Approval Email template which doesn't have any link to set passwords.
The correct email template should be like below:

Issue in ./help/merchandising-promotions/visual-merchandiser.md
Our store restricted admins are no longer able to set the position on products in a category via the drag/drop handles. The admins with the catalog responsibility are segregated by store and will not be global admins.

Issue in ./help/getting-started/compliance-cookie-law.md

There are links in this page that should be going to specific content/pages. But, those destination pages redirect back to this page. Is that intentional? Should they instead be deeplinks into this same page, such as scrolling to one of the subheadings of this page?

Thanks.
**Dan

Issue in ./help/content-design/adobe-stock-save-preview.md

Several broken links on page due to linking to relative links.

Issue in ./help/b2b/catalog-shared.md

In release notes 1.3.0 https://experienceleague.adobe.com/docs/commerce-admin/b2b/release-notes.html#b2b-v1.3.0
“When a merchant creates a shared catalog, permissions are now automatically set to Allow for the Display Product Prices and Add to Cart features in categories when the customer group is assigned this access in catalog permission settings. Previously, these settings were automatically set to Deny even when catalog permissions were set to Allow.

In the documentation on category permissions https://experienceleague.adobe.com/docs/commerce-admin/b2b/shared-catalogs/catalog-shared.html It seems to say that once the “shared catalog” feature is enabled, the “shared catalog” fully controls all category permissions so existing or new changes to the “category permissions” in the standard “catalog permission settings” are ignored. Changes to category permissions should be made from the shared catalog.

The “fix” in the release notes that seems to suggest you can still use category permissions settings to set permissions on shared catalog, where as the documentation suggests you cant, am I miss understanding this or is there a context for the "fix" that I am missing?

Issue in ./help/landing/home.md

e.g. https://experienceleague.adobe.com/docs/commerce-admin/user-guides/home.html?lang=ja

This page has MT widget, but even if we change the language to non-English, content won't be localized.

Issue in ./help/stores-purchase/order-archive.md

This section is not accurate and should be re-evaluated:

Adobe Commerce Support recommends enabling Order archiving to save MySQL disk space and improve checkout performance. See [Best practices for order placement performance ](https://support.magento.com/hc/en-us/articles/360048170772)in Adobe Commerce Support Knowledge Base.

There are no disk savings by implementing this. I'm also not sure how it would improve checkout performance - the linked article only suggests enabling asynchronous order processing: https://support.magento.com/hc/en-us/articles/360048170772

The archive orders functionality removes an order entry from the sales_order_grid table and move it to the magento_sales_order_grid_archive... all the other information will still be saved in the sales_order table.

The idea behind this functionality is that if you have fewer orders in the sales_order_grid table ( the table used by the grid in Sales > Operations > Orders), the load/search of that page will be quicker (the archived orders would be found in “Sales > Archive > Orders” instead)

Issue in ./help/catalog/product-price-special.md

Is there a formatting issue here?

https://experienceleague.adobe.com/docs/commerce-admin/catalog/products/pricing/product-price-special.html?lang=en#use-a-simple-start-and-end-date
https://experienceleague.adobe.com/docs/commerce-admin/catalog/products/pricing/product-price-special.html?lang=en#set-a-special-price-and-date-range-for-selected-products

If I copy the text and paste it, it looks like this:

Magento Open Source feature Alternative method required for Magento Open Source ([Learn more](https://experienceleague.adobe.com/docs/commerce-admin/user-guides/home.html?lang=en#product-editions))

Issue in ./help/configuration-reference/sales/sales.md

Remove the duplicate Order by SKU image

Issue in https://experienceleague.adobe.com/docs/commerce-admin/marketing/google-tools/google-tag-manager.html?lang=en

can you help me with the GTM_M2_Config.json for GA4?

Issue in ./help/getting-started/new-relic-reporting.md

I don't understand the need for this documentation - all preparatory actions have been taken to set up New Relic on Adobe Commerce Cloud per https://experienceleague.adobe.com/docs/commerce-admin/config/general/new-relic-reporting.html?lang=en

These configuration options do not apply to Adobe Commerce on Cloud Infrastructure.

If you are on the Pro plan, New Relic is already [preconfigured and enabled by default](https://experienceleague.adobe.com/docs/commerce-cloud-service/user-guide/monitor/new-relic/new-relic-service.html?lang=en). If you are on the Starter plan, you must complete the [New Relic configuration steps](https://experienceleague.adobe.com/docs/commerce-cloud-service/user-guide/monitor/new-relic/account-management.html?lang=en#configure-new-relic-for-starter-environment) that are part of the setup process.

The Starter plan is no longer being offered.

AS SUCH, Steps 1-4 should be removed.

Issue in ./help/systems/security-two-factor-authentication-use.md

In the Google Authenticator section, it shows a screencap with a checkbox for 'Trust this device, do not ask again' and states in point 4
"To save the authentication for future logins, select the Trust this device, do not ask again checkbox."

However from 2.4.2 onwards, this was removed and merchants no longer see this option, as implied in this comment on Stack Overflow
https://magento.stackexchange.com/questions/339801/magento-2-4-2-admin-2-factor-auth-not-enabling-trust-this-device

This is confusing merchants who have asked where the setting is on their installation. Please update the screencap and remove point 4.

Issue in ./help/getting-started/commerce-account-transfer.md

Please archive https://experienceleague.adobe.com/docs/commerce-admin/start/commerce-account/commerce-account-transfer.html as bug on entitlements syncing seen in MCLOUD-10555 is breaking entitlements when merchants attempt to do this process themselves.

Company email if you have any questions around this request: [email protected]

Kind regards,
Jake Ketterer
Snr Regional Support Manager - EMEA
Adobe Commerce