Menu
Feedback
Start here
Tutorials


Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Catalog
Products and SKUs
How to define the URL for a product page?

The URL of a product page is the electronic address that allows accessing this page on the Internet. Creating a friendly and optimized URL is crucial to make it easily findable by search engines and simplify your customer's experience on your ecommerce website.

The VTEX URL structure for a product page is composed of the store domain plus the value of the required textLink field when adding a product, plus /p, which stands for "product." For example: If the textLink field for a given product is populated with polo-shirt in a store with the domain storename.com, the URL's final structure will be storename.com/polo-shirt.

You can change the textLink of existing products anytime in the VTEX Admin, under Catalog > All products > Edit. We recommend filling in the field textLink with the product's name, using only the main keywords related to it.

Check out the Filling rules section to understand the restrictions on this field.

{"base64":"  ","img":{"width":1256,"height":930,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":78773,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Catalog/Products%20and%20SKUs/how-to-define-the-url-for-a-product-page_1.png"}}

You can also change a product's page URL using the Catalog API. In this case, you must change the field LinkId. See Update Product for more information.

Filling rules

Follow the rules below to fill in the textLink field:

  • Replace spaces with hyphens (-).
  • Use no more than 50 characters.
  • Do not use special characters like ! . * ' ( ) ; : @ & = + $ , / ? % # [ ] | or accents such as ´ ¨ ^ ~.
  • Do not use the following keywords since they are used for other features on the VTEX platform and may generate errors if applied to a product page's URL:
    • a
    • meta
    • api
    • admin

Please note that not complying with the rules listed above to complete the textLink field can affect your store's performance, lead to search issues, and interfere with the proper functioning of pages defined in the VTEX Admin.

Learn more

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Products and SKUs
« Previous
Defining the order of kit look products
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback