Skip to main content
 

How can we help?

Search

Articles in this section

Import and Export Replacements

  • Updated

Instead of adding replacements manually, you can import replacements from .csv files. This comes in handy if you store your preferred wording somewhere else. You can also export all of your sets and replacements if you need a backup.

Before you import

For a successful import, you'll need to make sure to format your file correctly. Your file can be comma delimited or semicolon delimited, and should use UTF-8 encoding.

Tip

If you need formatting help, you can download a sample spreadsheet from the import dialog. To download the spreadsheet, click the import icon 2023_03ReuseImprtIcon.png Import replacements in the Reuse section and click download the sample spreadsheet.

The structure should look like this:

2023_03ReuseImportSample.png

Field

Required or Optional

Description

ID

Required

The unique identifier of your replacement. This field can tie multiple rows together. If a replacement has multiple sets or several cases of unsuitable wording, each set or wording shares the same ID. This is only overridden when the import ID matches the ID in the database.

Tip

The ID isn’t visible in the UI. To find the ID for a replacement, export it. You'll find the ID next to the replacement in your .csv file.

Language

Required

The language code (for example: en, de). An import will update this field, if there are differences.

Active

Optional

Indicates if Acrolinx is set to check for the replacement. The default is active, which means Acrolinx will check for this replacement. Set it to inactive if you don't want Acrolinx to check for it.

Notice

The values of the import will replace the values in Acrolinx.

Possible values for active replacements are:

  • active

  • true

  • yes

Possible values for inactive replacements are:

  • inactive

  • false,

  • no

Set

Required

The set or sets to which the replacement belongs. This field can have 1 or more entries. If you want to define multiple sets for a replacement, each additional set should be in a new row. The replacement ID will stay the same across the rows.

Notice

The field is additive. If Replacement1 is in Set1 and you add Set2 to the import file, the replacement will be in both Set1 AND Set2 after the import.

Preferred

Required

The preferred wording. If there are differences, the preferred phrase or sentences that are defined in the import file will replace what's set in Acrolinx.

Description

Optional

Description of the replacement. If there are differences, the description added in the import file will replace the description defined in Acrolinx.

Unsuitable

Optional

One or more entries for unsuitable wording. Learn more about unsuitable wording before you add some to your file.

Notice

The field is additive. If a replacement has Unsuitable wording 1, and Unsuitable wording 2 is added to the import file, the file will have both after an import. To avoid duplicates, wording won't be added if there’s an exact content match (including things like white space and capitalization).

Import .csv files

Once you've formatted your file, follow these steps:

  1. In the Reuse section, click the import icon 2023_03ReuseImprtIcon.png Import replacements to open the import dialog.

  2. Click SELECT FILE to browse and select a file.

  3. Click IMPORT.

  4. A status window will open so you can track the progress of your import. If Acrolinx can’t import all of your replacements, you’ll get a list of the IDs that it couldn't import.

  5. Click CLOSE.

You’ll see your new sets in the Reuse section. Acrolinx adds replacements to existing sets if these are defined in the file.

Export

To export your sets and replacements, follow these steps:

  1. In the Reuse section, click the export icon Export replacements to open the export dialog.

  2. Click EXPORT.

A .csv file is saved to your preferred browser download folder.