Esko Logo Back to Esko Support
Choose your language for a machine translation:


When visualizing graphics in 3D in Share & Approve, users may select a Finishing Profile from a list of defaults. This Finishing Profile maps separation names to the 3D effects. Our list of default finishing profiles might not cover the names of you separations. In this article, we'll explain how you can write a Separation Mapping to let Share & Approve know how your separation names relate to our defaults.


We'll create a Separation Mapping by starting from an existing mapping.

  1. First download default.ssm. You may give it another name, but it should have the .ssm extension.
  2. Open the file with a simple text editor. The file contains all the mappings used.
    E.g.: All separations starting with "silver" or "silber" in the PDF are treated as if they were named "Silver", the separation name used in the default Finishing Profiles. If, for example, your separations are in Latin, you could add "argentum.*" to the Silver finishing.
    "Silver" : ["silver.*","silber.*", "argentum.*"]
    '.*' means any number of other characters. If your separation contains the word argentum, rather than beginning with it, you could add:
    "Silver" : ["silver.*","silber.*", ".*argentum.*"]
  3. When all the mappings have been made, save the file and upload it to your Share & Approve site.
  4. Open a graphical document to visualize it in 3D using the Share & Approve Viewer.
  5. Click the 3D button in the toolbar. The print finishing widget appears.
  6. Click the Finishing Profile drop down and select Configure Custom Finishing Profile.
  7. Select one of the default finishing profiles and click Configure Separation Mapping.
  8. Select your custom mapping and click OK.
  9. You have now set up your graphical document to use a finishing profile. If you are the Editor or Approval Master of this file, you can also choose to save the settings. Share & Approve will remember them the next time you open this file.
  • When saving the settings, ensure that the other users also have access to your separation mapping. You can do this by placing the .ssm file in the same folder as the graphical document and sharing the folder or adding it to a separate folder and sharing that one with everyone (e.g.: the group 'Users'). 
  • You can create mappings for White, Gold, Silver, Varnish, Emboss and Deboss. Two special names are added:
    • PMWRAPPER_DIECUT: defines which separations are to be considered as die-cut (for automatic die-cutting).
    • PMWRAPPER_HIDE: defines which separations have to be excluded from rendering (so which are not visible).
  • The .ssm file should be a valid JSON
  • Custom Finishing Profiles (.stf files) can be created using Studio Visualizer, a plugin for Adobe Illustrator®. This allows you to create even more effects and eliminates the need for a Separation Mapping.
  • For more information on how to use .stf files in Share & Approve, see this KB article: 
Article information
Applies to

Share & Approve



Last revised