AreaCacaoDocs
Sensory analysisProtocols

Create a custom protocol

Build your own set of attributes from the System catalog.

Goal

Create a custom protocol by selecting a subset of the catalog of 93 attributes. A custom protocol makes sense when the product you're tasting has a profile that no System protocol covers precisely (for example, a bonbon with unusual spices).

Pro plan or above, or a tasting pack with credit left. Creating protocols is part of the Sensory analysis module.

Steps

Open Protocols

Protocols is not in the sidebar. In the sidebar, under SENSORY ANALYSIS, click More in sensory to open the module hub; inside the hub, under Module areas, open the Protocols card.

Start a new protocol

You have two paths:

  • Click + New protocol from scratch to open the empty editor.
  • Or click Duplicate as custom on a System protocol that's close to what you want, to start from an editable copy. The copy inherits the original's attributes and its name comes prefixed with Copy of (for example, Copy of Master Chocolatier); change it to your own.

Fill in the general details

In the editor header:

  • Name of the protocol (for example, Madagascar 70% 2026 line tasting). It's required and must be between 3 and 120 characters.
  • Product type: pick one from the list of 27 types. It covers the module's full range, from cocoa beans, cocoa mass, and cocoa liquor, through the three chocolates (dark, milk, white), to fillings and finishes: ganaches, crunchy pralines, liquid praline, gianduja, caramels (soft, hard, salted), fondant, pâte de fruit and fruit cream, marshmallow, chocolate mousse, pastry cream, buttercream, marzipan, egg yolk/almond paste, rolled truffle, and compounds such as compound bonbon, bar with inclusions, and dragée. Each option is shown with its name in the interface language (for example, Cocoa beans, Firm ganache, or Pâte de fruits (fruit jelly)).
  • The Active (visible when creating new tastings) checkbox: leave it checked so the protocol shows up when creating tastings.
  • Rating scale: pick the scale your panel will use (0–10 (intensity), Hedonic 1–9 (Peryam), or Linear 0–100). If you leave it alone, it stays at 0–10. See Protocol rating scale.

There's no description field.

Add attributes from the catalog

The editor has two columns: Protocol attributes and Attribute catalog. Search the catalog (by name, key, or family) and click the + button on each attribute to add it to the protocol. Within the protocol you can reorder with the up/down arrows and remove the ones you don't want.

Save

The editor footer shows whether the protocol is Ready to save or displays N error(s) to fix before saving. The editor validates before letting you save: the name is required (between 3 and 120 characters), you must pick a product type, and you must add at least one attribute. When it's ready, click Save. The protocol becomes available in the Custom section and, if you left it Active, appears when creating new tastings.

Edit or delete one you already have

To tweak a custom protocol, open it from the Custom section of the list: it loads in the editor in edit mode, and you can change the name, product type, Active status, and the attribute list just as when you created it. To delete it, click Delete inside the editor and confirm; this can't be undone.

Tips

  • Less is more. A protocol with 30 attributes wears the panelist out. Start with 8 to 12 relevant attributes.
  • Balance categories. If your protocol only has aroma attributes, you'll miss textures and defects. Include at least one Mouthfeel attribute and one or more Defect attributes.

Next steps

On this page