Resource filters define exactly which files or assets should be synchronized between LingoHub and your connected integration (e.g., GitHub, GitLab, or Zendesk). By using the visual configuration tool, you can precisely include only the content that needs translation and exclude everything else.
How to access resource filters
To manage your synchronization rules, follow these steps:
Click Projects on the top navigation bar and select your project.
Go to the Settings tab.
Click on your specific integration tab (e.g., Integration (GitLab)).
In the Branches & Files section, find Files and click Configure.
Visual filtering and color labels
The Configure & sync files view lets you manage filters directly in the file tree and in the synchronization preview. Each folder and file is assigned a colored label to indicate its current status:
Included: This specific file or folder has been selected for synchronization.
Recursively Included: This folder is included because one of its parent directories has an "Include" filter applied.
Excluded: This file or folder has been marked for exclusion from synchronization.
Recursively Excluded: This folder is ignored because a parent directory has an "Exclude" filter applied.
How to apply filters
Managing your project structure is done through a combination of the file tree and the synchronization preview (“Files to be synchronized”):
Include files
Hover over any folder or file in the All files tree on the left. Click the Include button that appears next to the name.
The selection will appear in the Synchronization filters list on the right.
Exclude files
You have two ways to exclude content:
Via the preview: Hover over any file in the Files to be synchronized window (bottom right) and click the Exclude button that appears.
Via the filter bar: Above the file tree, change the dropdown from Include to Exclude, enter your pattern (e.g., android/**), and click Add filter.
Finalizing file synchronization
The Files to be synchronized section updates in real time to show the exact results of your rules. Once satisfied, click Apply & sync to save your configuration.
Filter syntax (wildcards)
The synchronization filters use the following wildcard logic to map your files:
Wildcard | Description | Example |
? | Matches one character | payment_e?.xml matches en, es, etc. |
* | Matches zero or more characters | *_en.xml matches all English XML files. |
** | Matches zero or more directories | android/**/strings.xml matches the file in any subfolder. |
Awesome! You have finished the article about resource filters. We hope that it helped you find answers to all your questions. Otherwise, contact our support, and we will gladly help!