Skip to main content

Settings > Insertion Position

Overview​

Controls the position to insert key/translation into files.

  • Type: enum
  • Key (in settings.json): kazoo.insertionPosition

Options​

End​

Inserts key at the end of the file/object

  • For example, given the following resources object:
    resources: {
        "accountInformation": "Account Information",
        "cancelMySubscription": "Cancel My Subscription",
        "checkOutFaq": "Check out our FAQs",
        "apple": "apple", // The new key would go here
    }

Loose Alphabetical​

Inserts key in best guess alphabetical order

  • Assumes the file is already sorted, and calculates the new index to insert the key.

  • For example, given the following resources object:

    resources: {
        "accountInformation": "Account Information",
        "apple": "apple", // The new key would go here
        "cancelMySubscription": "Cancel My Subscription",
        "checkOutFaq": "Check out our FAQs"
    }

  • If the object is not in alphabetical order, the key may be inserted in an unexpected location.

  • For example, given the following resources object:

    resources: {
        "accountInformation": "Account Information",
        "checkOutFaq": "Check out our FAQs",
        "cantaloupe": "cantaloupe", // The new key would go here, despite it belonging below 'cancelMySubscription'
        "cancelMySubscription": "Cancel My Subscription",
    }

Start​

Inserts key at the start of the file/object

  • For example, given the following resources object:

    resources: {
        "cantaloupe": "cantaloupe", // The new key would go here
        "accountInformation": "Account Information",
        "cancelMySubscription": "Cancel My Subscription",
        "checkOutFaq": "Check out our FAQs",
    }

Strict Alphabetical​

Inserts key in alphabetical order

  • Performs a full sort on the file, which is pretty slow (3-4 seconds for the culture files).

  • For example, given the following resources object:

    resources: {
        "accountInformation": "Account Information",
        "checkOutFaq": "Check out our FAQs",
        "cancelMySubscription": "Cancel My Subscription",
        "teamManagement": "Team Management",
        "subscriptionDetails": "Subscription Details",
    }

  • Inserting the key 'cantaloupe' would also re-sort the entire object:

    resources: {
        "accountInformation": "Account Information",
        "cancelMySubscription": "Cancel My Subscription",
        "cantaloupe": "cantaloupe", // The new key would go here
        "checkOutFaq": "Check out our FAQs",
        "subscriptionDetails": "Subscription Details",
        "teamManagement": "Team Management"
    }

  • Useful if you start to notice multiple discrepancies in the sorting of your file(s) and want to make sure everyone is on the same page.

Default Value​

Defaults to Loose Alphabetical due to its relative accuracy and speed. This may be changed in the future to Strict Alphabetical if the performance can be improved.