Marketing guidelines
Once you have developed your app, you have to prepare the App Page used to promote your app at the VTEX App Store. The App Page is the first point of contact for retailers to learn more about your app and decide whether it is suitable for their business.
Make sure to present your solutions professionally by adhering to the following principles:
- Clearly describe your appโs purpose and how merchants can benefit from it.
- Choose a product name that indicates the purpose of the app.
- Use high-quality images (icon and screenshots) and videos (if applicable).
Note that if we see room for improvement, weโll reach out to you before listing your app on the VTEX App Store.
Refer to the following sections to improve your App Page and increase its adoption on the VTEX App Store.
๏ธ
We recommend you follow these best practices while setting up the files that compose the marketing assets of an app. Please refer to this guide for more information.
Tone & Voice
Choose to favor the Serious and Authority tones. We understand that they capture the reliability and expertise our systemโs voice should have.
Tone and Voice | Description |
---|---|
Serious | Speak firmly, respectfully, and honestly - always with a more serious tone than playful. |
Authority | Speak with mastery, proficiency, and expertise. |
To see more about VTEXโs tone and voice, go to UX Writing Guidelines and VTEX Brand Guide pages.
Images
Images are a tool to express the visual identity of your app, make users learn more about the app, and reinforce your brand in the VTEX environment. The principles of a pack of images for the app are the following:
- Use high-quality images of your appโs UI to show the users how it behaves.
- Add one icon that represents your app that will appear in search results, the first page of VTEX App Store, and the Appโs page.
- Upload up to ten screenshots (appโs images) and a minimum of three.
- For storefront apps, combine Admin and storefront images to illustrate your appโs experience for both Merchant and Shopper.
- Add different mobile and desktop screenshots to improve the user experience depending on the screen.
Icon
Your app icon is one of the first elements of your app that developers and merchants see. It expresses the visual identity and reinforces your brand in the VTEX App Store environment.
Doโs and Donโts
- The icon must be in
PNG
format, a square image, without rounded corners. - The icon must have a minimum resolution of 1024 x 1024 pixels, a maximum resolution of 3000 x 3000 pixels, and a 1:1 ratio.
- The background of your icon must be transparent.
- The icon design must be simple and avoid unnecessary visual details. This will help merchants understand your app's purpose and have a better fit on smaller screens.
- The icon must not exceed 75% of the total space available of the icon size.
Show example


Screenshots
Use screenshots to visually represent your appโs key features and purpose.
Doโs and Donโts
- Provide three to five images showing the app on a Desktop and Mobile screen.
- Choose images of the app's interface and behavior, as well as the app's avaialble configurations on the Admin panel.
- Use the PNG format.
- The imageโs size must be up to 700 x 400 pixels.
- Ensure text in your images is localized according to the appโs applicable market.
- Screenshots must highlight the purpose, actions and benefits of the app.
- Do not use images that reveal real usernames and accounts. Opt to take images with fictional or blurred information.
- Do not fully maximize the window when taking a screenshot. It can damage the quality of the image.
Download and use our templates to create great app images for your App Page, such as the ones from the Live Shopping app.
Licenses
Licenses are written documents that contain the Terms and Conditions (T&C) of your app. They establish the direct business relationship between you, the developer, and the retailer that installs the app.
Doโs and Donโts
- Seek legal advice for the writing of your T&C.
- Prepare a Personal Data Governance Program, which includes clauses in its T&C on the subject, depending on the applicable legislation, in addition to tools that allow data subjects to exercise their rights.
- Consider wording limiting liability clauses.
- Remember to cover Intellectual Property issues.
- Offer the T&C in your Userโs language (Expected in English, Portuguese and Spanish).
- Analyze the consumer laws of the countries in which you operate, and offer consumers the rights provided.
- Review specific legislation related to your business, such as those issued by central banks if you are in financial services.
- Make it clear how you can hire your service: free, freemium, or premium, for example. Also, review the regulations regarding the payment methods you will accept.
๏ธ
The recommendations presented here are intended to serve as guidelines for the third-party developers and do not represent a legal recommendation. VTEX is not responsible for direct, indirect, moral, punitive damages, consequential damages or loss of profits arising from the use and/or compliance with these guidelines. Hiring legal advice is necessary and recommended for the final writing of terms and conditions for applications.
Messages
The textual content of your App Page must highlight your appโs purpose and features in a clear and concise way so merchants can easily understand your app.
Remember, your App Page is your main marketing tool and touchpoint with merchants.
Name - Required
The name of an app is decisive for how merchants will find your app on the VTEX App Store.
Doโs and Donโts
-
The app name must be a maximum of 26 characters.
-
Keep it concise and memorable. Ensure that it alludes to the experiences the app provides.
Show example
โ๏ธ
Live Shopping
โ
Live Shopping - The app that allows you to live stream events on your store's website.- Capitalize the first letter of each word.
Show example
โ๏ธ
Live Shopping
โ
Live shopping- Use & instead of And.
Show example
โ๏ธ
Reviews & Ratings
โ
Reviews and Ratings
- Do not include the word VTEX.
Show example
โ๏ธ
Abandoned Cart
โ
VTEX Abandoned Cart- Do not use punctuation, such as period, comma, exclamation point, question mark, semicolon, colon, and underscore unless itโs part of the actual company name.
Show example
โ๏ธ
Social Selling
โ
Social Selling- Do not include the version number of the app.
Show example
โ๏ธ
Google Tag Manager
โ
Google Tag Manager 2.xHeadline
The headline should describe the purpose of your app in a concise sentence.
Doโs and Donโts
-
The headline must have a maximum of 120 characters.
-
Summarize your appโs primary purpose and benefits in a descriptive and concise way.
Show example
โ๏ธ
Engage with customers through live broadcasts, real-time chat, and product promotion.
Create live broadcasts on your store, increase sales and boost customer interaction in real-time.
โ
Live broadcasts with customers.
Create Live streaming and sell more.
Show example
โ๏ธ
Set shipping address based on user browser's or IP Geolocation.
โ
This app attempts to determine the users' location and set their shipping address.
- Avoid repeating the application name.
Show example
โ๏ธ
Integrate your store with Google's navigation and conversion tracking platform.
โ
Google Tag Manager is the app to integrate your store with Google's navigation and conversion tracking platform.
Overview
The overview is the description of the app and should be an engaging message that focuses on how your app can benefit merchants in a clear and precise way.
Doโs and Donโts
- Write a short overview limited to a maximum of 200 characters.
- The app description must give a glimpse of your appโs benefits and functionalities, not a step-by-step on how it works.
Show example
โ๏ธ
Integrate with WordPress to bring blog data to your VTEX IO store and create a blog "homepage", category pages, and blog post pages.
โ
The Wordpress Integration app provides a way to bring in blog data from the Wordpress API and create a blog homepage, category pages, and blog post pages on your store, using your existing store header, footer, and styling.
- Consider your audience and describe why your app is important to the merchantโs store.
Show example
โ๏ธ
With The Live Shopping app, create live stream events on your store's website, promote product collections, increase sales, and enhance user experience simultaneously while interacting via live chat.
โ
Live shopping is an app to stream live events on your store in real-time.
- Use the active voice to give a sense of action to the user.
Show example
โ๏ธ
Offer an exclusive payment method to selected clients. With Customer Credit, you grant credit, determine limits, and manage invoices.
โ
With Customer Credit, the credit will be granted, limits determined, and invoices will be managed.
- Avoid technical and jargon language.
Show example
โ๏ธ
Interact with customers in real-time by generating personalized experiences through real-time chat and interactive like button.
โ
Interact with customers by managing the eventโs live chat in the events list clicking on the desired live eventโs arrow button.
Features
In features
, provide a list of your app's main features.
Doโs
-
Highlight which tasks can be performed within the app.
-
Write concise and brief descriptions (no more than 15 - 20 words).
-
Use bullet points to make the content easy to scan.
-
Describe what makes your app unique.
Show example
โ๏ธ
- Stream & Sell with the VTEX Live Shopping app. No need to hire a separate streaming platform.
- Highlight products in the live stream to increase sales.
- Add to cart alert: Show which products are trending and encourage the audience to add these products to their shopping cart.
โ
Stream and sell with the VTEX Live Shopping app without hiring a separate streaming platform. Also, highlight products during the live stream to increase sales.
Website URL
The Website URL is a hyperlink to your website to redirect users to your own corporate or app page. Website hyperlinks will be displayed in the sidebar of the App Page. This is an interesting component to present your solution in more depth to retailers browsing the VTEX App Store.
Do
- Enter a valid URL in this field to direct them to a landing page, "About Us" page, or your corporate website.
Support
Provide support information to make potential buyers aware of your support channels, such as email, a ticket portal, or a phone number. Including details on how support for your app works might make merchants more confident to choose your app.
Additional Information
Use this field to provide more specific details about the app. For example, is your app only available in certain regions? How the merchant will receive the appโs billing information? Is your app available only in specific environments (Legacy CMS Portal or VTEX IO)?
Do
- Write a summary, a maximum of 80 characters.
- Consider your appโs audience: regional location or global user, IO or Legacy user.
Show example
โ๏ธ
This application is only being made available in a Beta version.
If you do not have the integration done yet, you will need to complete the integration form.
We have three different plans that adjust to your content and commercial needs to have the most competitive rates.
โ
Simpler logistical operation and a reduction in logistical costs.
Automatic messages (after-sales)
Real-time metrics: After the end of the event, review quality KPIs such as likes, comments, and shares, as well as performance KPIs such as sales and average product value (AOV).
These describe the features of apps. Therefore, they should be in the feature section.
Video
Use videos to demonstrate how your app behaves in different scenarios. Videos are exciting resources to complement images as an educational tool showing your appโs main benefits and features.
Do's
- Feature videos of a maximum of 2 minutes.
- Make a video showing the main features and benefits of your app.
- Localize your video audio and or transcription according to your audience.
- Make visually compelling videos to attract attention from potential buyers of your app.
For example, check out the video for the Live Shopping app.
Metric description
๏ธ
Metric descriptios are required only for apps whose pricing is based on one or more metrics. If this is not the case, please do not fill in this field.
For each metric declared in the billingOptions
field (found in the app's manifest.json file), you must include a simple description of how it works. This description will help the extension buyer understand what each metric does and how it will impact the application billing.
Related Articles
Updated 22 days ago