Skip to main content

How to Save File Parsing Settings as a Reusable Filter

Save per-file-type parsing settings (CSV, JSON, DOCX, and more) as a named Filter under an Organizational Unit, then apply it to any future upload without reconfiguring.

wxrks lets you upload many different file formats into a project, and some of them — HTML, JSON, XML, and others — contain markup, tags, or metadata that isn't meant for translation. Instead of adjusting those upload parameters by hand on every project, you can save a configuration once as a named Filter and reuse it on any future upload of that file type.

💡 Who is this for? This guide is for Account Admins and Project Managers who need to save and reuse file parsing configuration across projects within the wxrks platform.


How Filters Work

A Filter is a saved set of parsing options for one specific file type (for example, .JSON or .CSV). Filters are tied to an Organizational Unit, so once you save one it becomes available on every project created under that Organizational Unit — you don't need to re-enter the same settings each time you upload a file of that type.

Every Filter shares three common fields regardless of file type:

  • Filter Name – the name you'll recognize it by when applying it later.

  • Apply segmentation to text – when on, wxrks applies its normal sentence/segment splitting rules to the file's text.

  • RegEx for tags – a regular expression identifying content to treat as a tag and exclude from translation.

Beyond those three, the available fields depend on the file type — JSON, DOCX, XLIFF, and the other supported formats each expose their own options. See How to configure your files when creating projects for what every field on every file type does; this article covers saving and reusing that configuration as a Filter, not the individual fields themselves.


Create a Filter

  1. Go to Organizations, open the Organizational Unit you want the Filter available on, and select its Project tab.

  2. Find the Filter Settings card and click the arrow to expand it.

  1. Click Add, then choose the file type this Filter will apply to. Each file type has its own specific fields, so pick the one that matches the files you'll be uploading.

  2. Fill in the Filter Name, toggle Apply segmentation to text, and set a RegEx for tags if you need one, then configure any additional fields specific to the file type you picked.

  1. Click Save. The new Filter now appears in the Filter Settings list and is available on any project under this Organizational Unit.

If the file type you're configuring is JSON, note that Show Comments In The Editor and Use Comments In CS can also be saved as part of the Filter — see How to configure your files when creating projects for what those two flags do.


Manage Your Filters

The Filter Settings list shows every saved Filter for this Organizational Unit, with a few controls per row:

  • Default – selecting this radio button makes the Filter the default for its file Type. Only one Filter per file type can be default at a time — setting a new one automatically replaces the previous default for that type.

  • Type – the file extension this Filter applies to.

  • Edit – opens the same fields you set when creating the Filter, so you can adjust them later.

  • Delete – permanently removes the Filter. This doesn't affect files that already used it — only future uploads.


Apply a Filter to an Uploaded File

When you upload a file into a project under the same Organizational Unit, you can apply any saved Filter for that file type without repeating its configuration:

  1. Upload your file as usual (during project creation, or when adding files to an existing project). If a default Filter exists for that file type, wxrks applies it automatically.

  2. To use a different saved Filter instead, open the file's settings card and click the Filters button. This lists your saved Filters for that file type — each one shown with its type badge, name, and a Default badge on whichever one is currently the default.

  3. Select the Filter you want to apply. Its saved parameters populate the fields immediately — you can still adjust any of them for this one upload without changing the saved Filter itself.


Related Articles

How to configure your files when creating projects – the full reference for what every upload parameter does, file type by file type.

Did this answer your question?