Skip to content

EDU-10181 | Update marketplace integration overview#2708

Open
anabaarbosa wants to merge 5 commits into
mainfrom
improvementmarketplace-start-guide
Open

EDU-10181 | Update marketplace integration overview#2708
anabaarbosa wants to merge 5 commits into
mainfrom
improvementmarketplace-start-guide

Conversation

@anabaarbosa
Copy link
Copy Markdown
Contributor

Summary

Update marketplace overview documentation to include new sections on customizing the storefront and multilevel omnichannel inventory. Added relevant links for further guidance and updated the last modified date.

Type of change

  • New content — Adds new documentation.
  • Content update — Improves existing documentation (clarity, structure, examples, accuracy).
  • Bug fix — Fixes markdown issues.
  • Editorial fix — Spelling, grammar, or minor copy edits that don’t change meaning.
  • Content removal — Deletes deprecated or obsolete content.

Checklist

  • The content follows the VTEX Style Guide.
  • Markdown renders correctly (headings, lists, tables, callouts).
  • Links, images, code blocks, and examples are valid.
  • Terminology, product names, and API references are consistent.
  • Frontmatter (title, description, tags, slug) is correct
  • Files follow the expected folder structure and naming conventions.

AI review instructions

This repository supports automated AI reviews for Markdown files in the docs folder, except docs/localization.

To run reviews on this PR, add at least one of the following labels:

  • AI style review: evaluates tone and adherence to VTEX style guidelines.
  • AI grammar review: identifies grammar and spelling issues.

Once at least one label is added, the review(s) will run automatically.

After the review is completed, the corresponding label will be removed and the label AI reviewed will be added to the PR.

Note

To rerun a review, remove and add the desired label again.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 29, 2026

👁️‍🗨️ Preview changes on Developer Portal

You can use the link below to load the Developer Portal in preview mode with the changes from this branch:

👉 Open preview environment

Below is the list of modified pages and their corresponding preview URLs:

File Preview URL Sidebar
docs/guides/Getting-Started/marketplace-overview.md https://developers.vtex.com/docs/guides/marketplace-overview ✅ Listed

- [Using CSS handles for store customizations](https://developers.vtex.com/docs/guides/vtex-io-documentation-using-css-handles-for-store-customization)
- [Working with Site Editor](https://developers.vtex.com/docs/guides/store-framework-working-with-site-editor)

### FastStore
Copy link
Copy Markdown
Contributor

@mariana-caetano mariana-caetano May 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Aqui serve para qualquer versão da FastStore? Pergunto por que temos 4 versões, mas a mais atualizada, que está recebendo novas contas, é a FastStore v4. Então, checaria com o pessoal se essa customização serve para todas as versões da FastStore ou apenas para a mais recente, FastStore v4. cc.: @manuellacorreia

Pontos que precisam de esclarecimentos aqui:

  • Para qual versão da FastStore essa customização serve?
    • Para todas? Então, uma ideia seria criar uma tabela que explique o que a pessoa precisa fazer em cada versão.
  • Está disponível para a versão v1? Se sim, vamos precisar alinhar com o time da FastStore (@manuellacorreia), pois é uma versão que não está mais sendo atualizada e também com suporte aos usuários limitado. Então precisamos entender quem ficaria responsável caso acontecesse algo do lado do cliente e precisasse de suporte, sendo que já declaramos nesta doc sobre o tópico de suporte e manutenção dessa versão..

Algumas diferenças entre as versões podem ser encontradas nesta doc.


### FastStore

- [Overrides overview](https://developers.vtex.com/docs/guides/faststore/overrides-overview)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documentação para Faststore v3. Se for possível fazer para v4, a nova documentação está sendo revisada pelo time e publicaremos ainda em junho.

Comment thread docs/guides/Getting-Started/marketplace-overview.md
Comment thread docs/guides/Getting-Started/marketplace-overview.md Outdated

As a VTEX marketplace, your storefront is where approved seller offers are displayed and where shoppers complete checkout. After integrating sellers and cataloging offers, you can customize how products and seller information appear to customers.

The customization approach depends on your storefront technology. See [Getting started with storefront solutions](https://developers.vtex.com/docs/guides/getting-started-with-storefront-solutions) to compare FastStore, Store Framework, and Legacy CMS Portal, including marketplace support for each option.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Quais seriam as orientações de customização para as lojas do CMS Portal (Legacy)? Quais guias o usuário pode seguir?

Comment thread docs/guides/Getting-Started/marketplace-overview.md
- [Using themes overview](https://developers.vtex.com/docs/guides/faststore/using-themes-overview)

### Checkout and seller display

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Não tenho certeza se seria o caso de abordar aqui, mas precisamos abordar o FastCheckout também? Acho que Karen pode ajudar.

Comment thread docs/guides/Getting-Started/marketplace-overview.md

As a VTEX marketplace, your storefront is where approved seller offers are displayed and where shoppers complete checkout. After integrating sellers and cataloging offers, you can customize how products and seller information appear to customers.

The customization approach depends on your storefront technology. See [Getting started with storefront solutions](https://developers.vtex.com/docs/guides/getting-started-with-storefront-solutions) to compare FastStore, Store Framework, and Legacy CMS Portal, including marketplace support for each option.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The customization approach depends on your storefront technology. See [Getting started with storefront solutions](https://developers.vtex.com/docs/guides/getting-started-with-storefront-solutions) to compare FastStore, Store Framework, and Legacy CMS Portal, including marketplace support for each option.
The customization approach depends on your storefront technology. See [Getting started with storefront solutions](https://developers.vtex.com/docs/guides/getting-started-with-storefront-solutions) to compare FastStore, Store Framework, and Legacy CMS Portal, including marketplace support for each option. Use the references below to follow the correct customization path for your storefront stack.

Comment thread docs/guides/Getting-Started/marketplace-overview.md

#### Seller selection at checkout

When multiple sellers offer the same SKU, the [white label seller selection algorithm](https://help.vtex.com/en/tutorial/white-label-sellers-selection-algorithm--3MemNQ4pKkWCpMdzI27AHa) determines which seller fulfills the item, considering criteria such as price and delivery conditions for the shopper's address. To configure how sellers are selected and displayed during checkout, see [Checkout overview](https://developers.vtex.com/docs/guides/checkout-overview).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[link-check] reported by reviewdog 🐶
🚨 Found a broken link in a Markdown Link (Error 404):
https://help.vtex.com/en/tutorial/white-label-sellers-selection-algorithm--3MemNQ4pKkWCpMdzI27AHa

👉 Please review this link before merging your Pull Request.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[link-check] reported by reviewdog 🐶
🚨 Found a broken link in a Markdown Link (Error 404):
https://help.vtex.com/en/tutorial/offer-management--7MRb9S78aBdZjFGpbuffpE

👉 Please review this link before merging your Pull Request.

[Offer Management](https://help.vtex.com/en/tutorial/offer-management--7MRb9S78aBdZjFGpbuffpE) is the VTEX feature that provides sellers with more visibility into the process of sending a product to external channels, such as marketplaces. Offer Management helps sellers identify updates and resolve errors in their offers during the sending process, ensuring that they can be sent to the marketplace and synchronized correctly.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Suggestions"]

https://github.com/vtexdocs/dev-portal-content/blob/a00bb45e66a0d5dcb3c7dfee95995c81cb1593ec/docs/guides/Getting-Started/marketplace-overview.md#L255

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Versions"]

https://github.com/vtexdocs/dev-portal-content/blob/a00bb45e66a0d5dcb3c7dfee95995c81cb1593ec/docs/guides/Getting-Started/marketplace-overview.md#L260

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants