Transifex

  • Documentation
  • Translation Quality Tools
  • Adding Style Guides

Adding Style Guides

Note

Style Guides are only available on the Advanced plan and up. Any user can view a style guide, but only Organization Admins can create one.

Every person and every brand has a voice that’s unique to them. To help ensure translations are consistent with your brand across all languages, Transifex lets you provide style guides for your translators. But what’s a style guide? It’s simply a set of guidelines about how your brand ought to be presented. Later in this article, we’ll go over some things you might want to include in your style guide.

Adding style guides

To create a style guide:

  • Head to your Organization Settings from the main navigation.

  • On the left menu, click on Style Guides.

  • Click on Add a Style Guide.

  • Give your style guide a title, then put in your style guide content. Whenever you create a new style guide in Transifex, you’ll see a style guide outline in the content box. You can use it as a reference or create a style guide following your own structure. 

    style-guide-edit.png#asset:3390

  • Hit Save to finish creating your style guide.

A Table of Contents will be automatically generated for translators using the Heading 1's and Heading 2's in your style guide.

Things you might include in a style guide

It’s up to you how much or how little information you include in your style guide. If you’re working with a translation agency, they can often work with you to create a style guide specific to your company. In general though, style guides contain some variation of the following:

  • Background information on your company, product, and target market
  • Information about your brand’s personality, tone, and voice
  • Guidelines for grammar, written syntax (e.g. how should dates be written), and stylistic preferences
  • Language/culture-specific information or instructions

Examples of style guides 

Below are a few public style guides you can look at for reference:

Assigning style guides to projects

Once you’ve created a style guide, you can assign it to one or more of your projects:

  • From the Style Guides overview page, click on the style guide you want to assign to a project.

    style-guides-dropdown.png#asset:3394

  • In the Assign project dropdown, use the checkboxes to select the project(s) you want to assign the style guide to. When done, click outside of the dropdown.

    style-guide-assignment.png#asset:3391

To unlink a style guide and project, simply uncheck the project in the dropdown.

Note

A project can only have one style guide assigned to it at a time.

Viewing style guides

Translators and Reviewers can access and view style guides in several ways:

  • By clicking the Style guide button in the header of the Editorstyle-guide-button-editor.png#asset:3392
  • By clicking View style guide from the top of the Languages page of a project
    style-guide-languages.png#asset:3393