vtexdocs · PedroAntunesCosta · Nov 7, 2024 · Nov 7, 2024 · Nov 7, 2024 · Nov 8, 2024
diff --git a/README.md b/README.md
@@ -8,6 +8,20 @@ You will find the following folders in this repository:
 
 -TBD
 
+## Troubleshooting tags
+
+We use tags in troubleshooting articles to make it easier for our readers to filter and find content.
+
+When publishing a troubleshooting article, you can add up to five tags, by adding them in the `tags` frontmatter field, separated by comma. See an example below:
+
+```
+---
+...
+tags:  Orders, Integration, Marketplace, Amazon
+...
+---
+```
+
 ## Contributing with Help Center Portal documentation
 
 We're so glad you're here! Thanks for being interested.
@@ -28,30 +42,30 @@ If you need to use an illustration that exceeds this value, you can compress it
 2. Copy the file you want to make available for download to the same directory as the article where it will be inserted. For instance, to attach a spreadsheet within an article located at `docs/pt/tutorials/Payments/Payment Settings/list-of-payment-providers-by-country.md`, you need to save it in the directory `docs/pt/tutorials/Payments/Payment Settings.`
 3. Go to the [branches page](https://github.com/vtexdocs/help-center-content/branches), and under **Your branches** section, click on the name of the branch you created.
 
-![Branches_page](https://raw.githubusercontent.com/vtexdocs/help-center-content/main/readme-images/readme-download-illustration-1.png)
+![Branches_page](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 4. Locate the folder where you saved the file and click on it.
 
-![File_folder](https://raw.githubusercontent.com/vtexdocs/help-center-content/main/readme-images/readme-download-illustration-2.png)
+![File_folder](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_2.png)
 
 5. Right-click on the **Raw** option and select **Copy link address (Copiar endereço do link)**.
 
-![Raw_link_information](https://raw.githubusercontent.com/vtexdocs/help-center-content/main/readme-images/readme-download-illustration-3.png)
+![Raw_link_information](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_3.png)
 
 > ℹ️ Address link example: `https://github.com/vtexdocs/help-center-content/raw/main/docs/pt/tutorials/Payments/Payment%20Settings/Payment%20Provider%20x%20Countries%20-%20August%202024.xlsx`
 
 6. Access the article where you want to add the file and insert the link obtained in the previous step in the desired location.
 
-![Add_link_in_article](https://raw.githubusercontent.com/vtexdocs/help-center-content/main/readme-images/readme-download-illustration-4.png)
+![Add_link_in_article](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_4.png)
 
 7. Return to the main branch by clicking **Main** in the **Branches** tab.
 
-![Main branch](https://raw.githubusercontent.com/vtexdocs/help-center-content/main/readme-images/readme-download-illustration-5.png)
+![Main branch](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_5.png)
 
 8. Submit your PR for review.
 
 ## Track articles
 
 Track articles' titles must contain the reference numbers in the navigation, but not in the title of the article page.
 
-![image](https://raw.githubusercontent.com/vtexdocs/help-center-content/main/readme-images/readme-track-illustration-6.png)
+![image](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_6.png)
diff --git a/_1.PNG b/_1.PNG
diff --git a/_1.png b/_1.png
diff --git a/_2.png b/_2.png
diff --git a/docs-utils/troubleshooting-structure-adjustment.js b/docs-utils/troubleshooting-structure-adjustment.js
@@ -0,0 +1,52 @@
+// We couldn't get this to work by being called at index.js. This has to be run manually
+const fs = require('fs');
+const path = require('path');
+
+const locales = ['en', 'pt', 'es']
+
+function moveArticleTagsToFrontmatter(filePath) {
+
+    const fileContent = fs.readFileSync(filePath, 'utf-8')
+
+    if (fileContent.includes('**Tags:**')) {
+        const tags = fileContent.split('**Tags:**')[1].split('\n')[0]
+        const frontMatter = fileContent.split('---')[1]
+        const text = fileContent.split('---')[2].replace(/^.*Tags:.*$/m, '').trim()
+
+        // Assemble everything
+        const newContent = '---'+frontMatter+`tags: ${tags}\n---\n\n`+text
+
+        fs.writeFileSync(filePath, newContent)
+    }
+}
+
+function moveAllTags(folderPath) {
+
+    console.log('Adjusting tags')
+    const folderContent = fs.readdirSync(folderPath)
+    for (dir of folderContent) {
+        dir = `${folderPath}/${dir}`
+        console.log(dir)
+        if (fs.statSync(dir).isFile() && (dir.endsWith('.md') || dir.endsWith('.mdx'))) {
+            console.log('FILE')
+            moveArticleTagsToFrontmatter(dir)
+        } else {
+            console.log('FOLDER')
+            moveAllTags(dir)
+        }
+    }
+}
+
+async function adjustTroubleshootingContent() {
+    console.log('Adjusting troubleshooting content...')
+    for (locale of locales) {
+        const oldPath = path.resolve(`../help-center-content/docs/${locale}/tutorials/troubleshooting`)
+        const newPath = path.resolve(`../help-center-content/docs/${locale}/troubleshooting`)
+        fs.renameSync(oldPath, newPath)
+        moveAllTags(newPath)
+    }
+}
+
+adjustTroubleshootingContent()
+
+module.exports = { adjustTroubleshootingContent }
diff --git a/.../en/announcements/2017-10-25-facebook-and-google-login-settings-have-changed.md b/.../en/announcements/2017-10-25-facebook-and-google-login-settings-have-changed.md
@@ -21,6 +21,6 @@ The flag __Use VTEX keys__, which previously activated the use of data provided
 
 This means that the stream has been fixed and it is no longer possible to use VTEX keys to login with Facebook and Google. Now retailers need to set up their own keys.
 
-![login2](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2017-10-25-facebook-and-google-login-settings-have-changed_1.png)
+![login2](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 This change does not have any negative impact on your store. However, if some customization was done wrongly on your login screen, crashes may occur. So check out your login screen to make sure everything goes like it used to.
diff --git a/docs/en/announcements/2017-10-25-vtex-login-now-features-recaptcha.md b/docs/en/announcements/2017-10-25-vtex-login-now-features-recaptcha.md
@@ -19,7 +19,7 @@ VTEX login via e-mail and password now features reCAPTCHA, which makes store acc
 
 We use Invisible reCAPTCHA, a Google technology that determines when it's necessary to confirm whether the access attempt is being made by a robot or a human.
 
-![reCAPTCHA](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2017-10-25-vtex-login-now-features-recaptcha_1.png)
+![reCAPTCHA](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 This means that the confirmation request may or may not appear, depending on several variables.
 

diff --git a/...n/announcements/2017-10-30-maximum-price-per-item-promotion-will-be-disabled.md b/...n/announcements/2017-10-30-maximum-price-per-item-promotion-will-be-disabled.md
@@ -33,7 +33,7 @@ There are two possible ways to achieve the same effect of the Maximum Price per
 
 You can set up a [Regular Promotion](/en/tutorial/regular-promotion) with the __Maximum Price per Item__ discount.
 
-![PrecoMaximoEN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2017-10-30-maximum-price-per-item-promotion-will-be-disabled_1.png)
+![PrecoMaximoEN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 This is a better scenario than the previous one, since retailers have more options for grouping, for example, by product category.
 

diff --git a/.../en/announcements/2017-11-14-were-launching-your-personal-data-set-up-screen.md b/.../en/announcements/2017-11-14-were-launching-your-personal-data-set-up-screen.md
@@ -19,7 +19,7 @@ It has become easier to edit your personal VTEX Admin access settings.
 
 VTEX ID team has created the My User screen, which can be easily accessed by the Admin topbar.
 
-![dadosPessoais](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2017-11-14-were-launching-your-personal-data-set-up-screen_1.png)
+![dadosPessoais](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 In this screen you can:
 - View your email registered on Admin.

diff --git a/docs/en/announcements/2018-02-15-my-orders-is-now-available-on-extension-store.md b/docs/en/announcements/2018-02-15-my-orders-is-now-available-on-extension-store.md
@@ -12,7 +12,7 @@ slugEN: 2018-02-15-my-orders-is-now-available-on-extension-store
 locale: en
 legacySlug: my-orders-is-now-available-on-extension-store
 announcementImageID: ''
-announcementSynopsisEN: "Starting June 5, the use of the 'My Orders' page's extension will be required for all stores."
+announcementSynopsisEN: "Starting June 5, the use of the "My Orders" page's extension will be required for all stores."
 ---
 
 >ℹ️ As announced here, **My Orders extension** is already mandatory to all stores. Since **June 6**, it is available by default and is not accessible through VTEX's App Store anymore.

diff --git a/docs/en/announcements/2018-07-12-catalogs-new-visual-and-navigation.md b/docs/en/announcements/2018-07-12-catalogs-new-visual-and-navigation.md
@@ -23,16 +23,16 @@ The main difference to the old version is on how you navigate through it. We've
 ## What has changed
 
 Most items of the old Catalog can now be found on the _Catalog_ option, on the sidebar's _PRODUCTS_ section.
-![EN-Catálogo1](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-07-12-catalogs-new-visual-and-navigation_1.png)
+![EN-Catálogo1](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 
 The _Gift card_ subitem (formerly known as _Vouchers_ and previously located under the _Campaign Control_ tab) is now one of the _Payments_ drop-down options, on the sidebar's _TRANSACTIONS_ section. 
-![EN-Catálogo2](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-07-12-catalogs-new-visual-and-navigation_2.png)
+![EN-Catálogo2](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_2.png)
 
 
 The _Settings_ item (formerly a tab of its own) is now one of the _CMS_ drop-down options, on the sidebar's _STORE SETUP_ section. 
-![EN-Catálogo3](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-07-12-catalogs-new-visual-and-navigation_3.png)
+![EN-Catálogo3](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_3.png)
 
 
 The former _Marketplace_ tab continues independent (even the name remains the same), with a section of its own on the sidebar.
-![EN-Catálogo4](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-07-12-catalogs-new-visual-and-navigation_4.png)
+![EN-Catálogo4](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_4.png)
diff --git a/...uncements/2018-08-13-mudanca-na-concatenacao-reduz-erros-no-envio-de-e-mails.md b/...uncements/2018-08-13-mudanca-na-concatenacao-reduz-erros-no-envio-de-e-mails.md
@@ -19,14 +19,14 @@ From now on, your store can use a semicolon (`;`) to concatenate e-mail addresse
 
 This feature works for both the copy field (`Cc`) and the hidden copy field (`Bcc`), just as the comma already worked. The two concatenation options are now valid.
 
-![Message Center bug fix - EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-08-13-mudanca-na-concatenacao-reduz-erros-no-envio-de-e-mails_1.png)
+![Message Center bug fix - EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 This simple change in the module responsible for sending transactional emails dramatically reduced the error rate on customer communications.
 
 The chart below shows the error rate of a store before we implemented the support for semicolon concatenation. More than 90% of e-mails failed every day.
 
-![Message Center bug fix 2](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-08-13-mudanca-na-concatenacao-reduz-erros-no-envio-de-e-mails_2.png)
+![Message Center bug fix 2](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_2.png)
 
 After the improvement was implemented, the errors in sending transactional emails from the same store were completely eliminated, as this other chart shows:
 
-![Message Center bug fix 3](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-08-13-mudanca-na-concatenacao-reduz-erros-no-envio-de-e-mails_3.png)
+![Message Center bug fix 3](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_3.png)
diff --git a/...18-09-19-get-your-store-ready-for-black-friday-with-our-best-practices-guide.md b/...18-09-19-get-your-store-ready-for-black-friday-with-our-best-practices-guide.md
@@ -21,4 +21,4 @@ As in previous years, we came up with a guide with recommendations and exclusive
 
 The guide is available to all our clients and partners and may be accessed through the homepage of your Admin or directly through the URL `https://{AccountName}.myvtex.com/admin/blackfriday`. Just replace `{AccountName}` with your store's Account Name.
 
-![Announcement Cartilha BF - EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-09-19-get-your-store-ready-for-black-friday-with-our-best-practices-guide_1.png)
+![Announcement Cartilha BF - EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
diff --git a/...0-23-sell-more-with-the-app-that-integrates-your-business-to-google-shopping.md b/...0-23-sell-more-with-the-app-that-integrates-your-business-to-google-shopping.md
@@ -19,7 +19,7 @@ __Black Friday__ is coming. And with it comes the need to use this unique opport
 
 To help you with this task, VTEX is launching an __exclusive app in partnership with Google__, which will be available in our [App Store](https://apps.vtex.com/vtex-google-shopping/p).
 
-![Google Shopping App](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-10-23-sell-more-with-the-app-that-integrates-your-business-to-google-shopping_1.png)
+![Google Shopping App](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 It integrates your business with Google Ads and allows you to advertise your products on Google Shopping, using the new Smart Shopping Campaigns, and track the results easily and quickly.
 

diff --git a/...cements/2019-03-26-increase-your-sales-with-a-new-order-authorization-screen.md b/...cements/2019-03-26-increase-your-sales-with-a-new-order-authorization-screen.md
@@ -22,7 +22,7 @@ This tool allows to control order approvals with changes in their values. The ch
 ## What changes? 
 Now, instead of opening a ticket directly with the support, you can manage the authorization rules by admin. To do this, go to the path: Menu - Order Management - Order Authorization.
 
-![ENAutorizacaoPedidos.PNG?h=250](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-03-26-increase-your-sales-with-a-new-order-authorization-screen_1.png)
+![ENAutorizacaoPedidos.PNG?h=250](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 ## What you need to do
 It is important to mention that the store will not lose the previous rules, which were done by opening a ticket to the support team. They will automatically update on the new screen.

diff --git a/...2019-06-06-ensure-more-safety-and-control-on-your-order-authorization-screen.md b/...2019-06-06-ensure-more-safety-and-control-on-your-order-authorization-screen.md
@@ -36,6 +36,6 @@ In order to do this, you need to add a product called `Order Authorization` to t
 6. Choose the type of permission you wish to grant: either `Save Configuration` if you want to allow the user to edit and save changes, or `View Configuration` if you want the user to only view the Order Authorization page.
 7. Finally, click on **Save**.
 
-![GIT-OrderAutho.en](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-06-06-ensure-more-safety-and-control-on-your-order-authorization-screen_1.gif)
+![GIT-OrderAutho.en](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.gif)
 
 Upon adding this new product to a profile, ensure that the desired users are in fact linked to this profile.
diff --git a/...-06-07-you-can-now-restrict-user-access-to-the-settings-screen-on-the-orders.md b/...-06-07-you-can-now-restrict-user-access-to-the-settings-screen-on-the-orders.md
@@ -19,7 +19,7 @@ announcementSynopsisEN: 'Possibility to limit user access to the Settings screen
 
 Seeking to ensure greater safety, we created the possibility to limit user access to the **Settings** screen on the Orders Management module, allowing information to be edited by selected users only. 
 
-![2019-06-07 17 24 10-Settings.en](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-06-07-you-can-now-restrict-user-access-to-the-settings-screen-on-the-orders_1.png)
+![2019-06-07 17 24 10-Settings.en](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 ## Main Advantages 
 
@@ -39,7 +39,7 @@ In order to do this, you need to add a product called `Checkout` to the desired
 6. Choose the type of permission you wish to grant: either `Save Order Configuration` if you want to allow the user to edit the **Orders** secction, or `Save OrderForm Configuration` if you want the user to edit the **Cart** section.
 7. Finally, click on **Save**.
 
-![GIT-Checkout.en](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-06-07-you-can-now-restrict-user-access-to-the-settings-screen-on-the-orders_2.gif)
+![GIT-Checkout.en](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_2.gif)
 
 Upon adding this new product to a profile, ensure that the desired users are in fact linked to this profile.
 
diff --git a/.../2019-06-27-gain-speed-and-practicality-with-the-updated-price-table-feature.md b/.../2019-06-27-gain-speed-and-practicality-with-the-updated-price-table-feature.md
@@ -20,7 +20,7 @@ It is now possible to create Price Tables in a more intuitive, practical and fas
 ## What changes
 Before, to create a Price Table, it was necessary to acess the Prices module filter and enter the name of the table to be created. Now, we've added a new __Price Table__ button that allows you to create and select the price table you want to view.
 
-![Annoucement Price Table EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-06-27-gain-speed-and-practicality-with-the-updated-price-table-feature_1.png)
+![Annoucement Price Table EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 ## Advantages
 

diff --git a/docs/en/announcements/2019-08-12-update-grants-in-the-promotions-module.md b/docs/en/announcements/2019-08-12-update-grants-in-the-promotions-module.md
@@ -37,4 +37,4 @@ This update gives you more power over your promotions' behavior. The new buttons
 6. Tick the box next to **Use recurrence settings**
 7. Set the desired days and schedule for that promotion 
 
-![CRON 2 EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-08-12-update-grants-in-the-promotions-module_1.png)
+![CRON 2 EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
diff --git a/docs/en/announcements/2019-08-23-novo-layout-no-e-mail-de-codigo-de-acesso.md b/docs/en/announcements/2019-08-23-novo-layout-no-e-mail-de-codigo-de-acesso.md
@@ -17,7 +17,7 @@ announcementSynopsisEN: "We've updated the layout for the email you receive when
 
 We've updated the layout for the email you receive when requesting an access code for your admin. From now on, every time access to login or change password is requested, you'll receive an email as the one shown below:
 
-![announcement-novo-layout-email-codigo-acesso EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-08-23-novo-layout-no-e-mail-de-codigo-de-acesso_1.png)
+![announcement-novo-layout-email-codigo-acesso EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)
 
 ## What changes
 The new version makes the layout more seamless and usable, in addition to making it more coherent with VTEX's visual identity.

diff --git a/docs/en/announcements/2019-09-09-marketplaces-received-skus-beta.md b/docs/en/announcements/2019-09-09-marketplaces-received-skus-beta.md
@@ -25,21 +25,21 @@ This open beta is the first in a series of product updates and improvements to c
 
 One of the first and principal improvements is the new way to select SKUs en masse — so you can approve or reject them in bulk. Aligned with our [Styleguide](https://styleguide.vtex.com/ "Styleguide"), the bulk selection will make your work faster and better.
 
-![received-skus-bulk](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-09-09-marketplaces-received-skus-beta_1.gif)
+![received-skus-bulk](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.gif)
 
 
 
 ## Ordering and Filtering
 One of the challenges in managing items from multiple sellers is prioritizing your never-ending items list. To help you with that we've built a brand new __ordering__ feature, where you can reorder all submissions according to price and – one of the main improvements – by inventory availability. See how many items are available at a glance, so you can approve the SKUs that will perform better.
 
 
-![received-skus-ordering](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-09-09-marketplaces-received-skus-beta_2.gif)
+![received-skus-ordering](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_2.gif)
 
 
 This extends to the new __filtering__ tool. See and filter SKUs by category, brand, and seller in a simple and intuitive way.
 
 
-![received-skus-filtering](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2019-09-09-marketplaces-received-skus-beta_3.gif)
+![received-skus-filtering](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_3.gif)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -21,4 +21,4 @@ As in previous years, we came up with a guide with recommendations and exclusive

		The guide is available to all our clients and partners and may be accessed through the homepage of your Admin or directly through the URL `https://{AccountName}.myvtex.com/admin/blackfriday`. Just replace `{AccountName}` with your store's Account Name.

		![Announcement Cartilha BF - EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/announcements/2018-09-19-get-your-store-ready-for-black-friday-with-our-best-practices-guide_1.png)
		![Announcement Cartilha BF - EN](https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/_1.png)