Last updated
Change template texts
This guide gives an overview how to change the user interface texts in the Sharetribe Web Template.
Table of Contents
The template has several types of texts that can be read in the user interface. The most extensive group of UI texts is microcopy, but the template also has content pages, as well as some other groups of content that can be configured in the code base.
Microcopy
In the Sharetribe Web Template, user-facing content is not written directly into the source code. Instead, the source code uses
React Intl message formatting that defines keys for each meaningful piece of content, and a translator or a content creator can then define the message (i.e. the value) for each key in their language. Read more about how Flex handles microcopy.
By default, the template use built-in language-specific microcopy files to show microcopy messages in the UI. However, starting in 2022-05, operators can also modify microcopy in Flex Console using hosted microcopy assets. The built-in microcopy is merged with the hosted microcopy in the template, so you can use both ways of managing microcopy. Read more about how to modify built-in microcopy in the template and how hosted microcopy work in the template.
You may also want to change the language of the user interface entirely. Read more about changing the language used in the template.
In addition to microcopy, there are other forms of content in the client applications that operators may need to manage.
Content pages
Your marketplace also has some content pages that can be modified through Flex Console. The default content pages include
- About
- Landing page
- Privacy Policy
- Terms of Service
These pages are rendered by the PageBuilder component in the template. In addition to these default pages, you can create your own content pages through Flex Console, and fully manage their content without code changes. On the template side, you can modify how that content is displayed.
Static pages
It is possible to create fully static pages in the Sharetribe Web Template. You might want to do this if you e.g. want to create static content pages for performance reasons.
More information about adding static content to the application can be found in the How to add static pages in the template guide.
Labels and countries
There are few other cases where we haven't added microcopy directly to the microcopy files.
Labels for filters can be found in config/configListing.js.
Country codes are in a separate file as well. Stripe API requires country information as ISO 3166-1 alpha-2 codes. These are used when billing address is asked in StripePaymentForm on CheckoutPage.
└── src
└── translations
└── countryCodes.js