↑↓ selectEnter openEsc close

    1. Elbuz

    Contact directories: groups, stages, sources, ownership forms

    6 min readUpdated

    Contact directories hold the lists a customer card picks from: role, stage, source, department, position, business area, ownership form, country. You edit them in the table.

    When you need this:

    • A new role, such as “VIP” or “Wholesalers” — a group color shows it as a chip.
    • A new supplier group isn't in price lists — “Show in Price lists” adds its contacts to the tree.
    • Customers come from Epicentr or trade shows — a new source shows in the card, filter and analytics.
    • The invoice needs «ТОВ» (LLC) — the ownership form prints its “Name”.

    Where to start: “Contacts” list menu → “References”, the “+” button.

    What contact directories do

    How directories work and how to add an entry

    The card's lists of roles, stages, sources, departments, positions, business areas and ownership forms are separate directories. All except stages open from the “Contacts” list menu, “References” section. “Contact groups” is also in the menu: Directories → Contacts → Account groups. Stages open from the card — the gear next to the “Customer stage” field.

    They all work the same way. At the top there's a hint: “Edit right in the table: double-click a cell. Add a new entry with the button on the left.”

    • New entry. The “Add” button on the left of the header (tooltip “Add a directory entry”) creates an empty row and puts the cursor in its “Name” — type the name and press Enter.
    • Editing. Double-click a cell to edit it; it saves on its own (except stage colors), with a “Successfully updated” pop-up.
    • Other buttons. Next to it are the “Delete” button, grid refresh and filter reset; at the bottom is the “Total:” counter.
    • “Activity”. When “Activity” is cleared for a stage, source, department, position, business area or ownership form, the card stops offering it in its fields, but the entry stays in the directory. For contact groups, “Activity” doesn't narrow the list of roles in the card.
    Contact groups directory with five groups, colors and price list visibility flags
    1Color
    2Show in Price lists
    3Add button
    1. Color — edited with a palette on double click.
    2. Show in Price lists — without it the group's contacts do not appear in the price list tree.
    3. Add button — adds a new group record.
    Contact directories
    DirectoryColumnsWhere it shows in the card
    Contact groupsID, Activity, Name, Note, Color, Show in Price lists, Default, On site, At registration, Main on sitethe “Contact type” field in “Overview” — this is the record's role
    Contact statusesActivity, Name, Note, Color (display only), Sort Order, Defaultthe “Customer stage” field in “Overview”
    Contact sourcesActivity, Name, Note, Sort Orderthe source field in the “Marketing” section
    Departments and divisionsActivity, Name, Note, Sort Orderthe “Department / Division” field in “Overview”
    Positions and roles of employeesActivity, Name, Group, Note, Sort Orderthe “Position” field in “Overview”
    Business areasActivity, Name, Note, Sort Orderthe “Business area” field in the “Company” section — its list of values comes from this directory
    Ownership formsActivity, Name, Short name, Group, Sort Orderthe “Ownership form” field in the “Company” section

    How to add a role and show suppliers in the price list tree

    A group is the record's role: supplier, competitor, customer, partner, other. Group properties — name, color, checkboxes — are edited right in the grid of the “Contact groups” directory (Directories → Contacts → Account groups, or the “Contacts” list menu → “References”).

    ID. The first column is the group's numeric code. It's assigned automatically and can't be edited.

    New group. The “Add” button in the directory header creates an empty row and puts the cursor in its “Name” — type “VIP” or “Wholesalers” and press Enter. A new group is created with “Activity” on, no color and no “Show in Price lists” checkbox.

    Another way is to rename a group you don't need: double-click the “Name” of “Partner” or “Other”. Contacts that already had this role will also become “VIP”, so move them to another role first. A group can also be created through the API, with the api/contractor/contractor_group_add method and a name.

    Color. This sets how the group looks: double-click the “Color” cell to open the palette, pick a shade, and the group shows as a colored chip next to the name in the contact list and as a mark in the price list tree. An empty color shows as a dash.

    “Show in Price lists”. This checkbox in the group grid decides whether the group's contacts go into the price list tree. By default it's on for “Supplier” and “Competitor”. A new group (via “+” or the API) or one renamed from “Partner” or “Other” lacks it, so it isn't in the tree. Tick it right in the grid.

    Two more conditions: the tree shows not the group itself but contacts with this role, so at least one record needs its “Contact type” changed to this group; and the record must have “Activity” on.

    Changing a group's “Activity” applies it to every contact in that group. Clear it, and all the group's contacts are deactivated and disappear from the price list tree. Set it again, and all of them are activated, including those you deactivated by hand. Editing the name, color or other checkboxes doesn't change contacts' activity.

    The “Default” flag on a group doesn't affect the “Add” button: a new card still gets the “Supplier” role.

    How to turn a contact group into a customer group on an Elbuz CMS site

    Customer groups of an Elbuz CMS store — “Retail”, “Wholesale”, “Dealers”, “Dropshippers” — are set in Elbuz, in the same “Contact groups” directory. A marked group appears on the site with the next catalog export, together with that group's prices. You don't need to create groups in the site admin.

    Where: Directories → Contacts → Account groups, the last three columns

    Contact groups grid scrolled right to the On site, At registration and Main on site columns
    1On site
    2At registration
    3Main on site
    1. On site — shows the group on the storefront.
    2. At registration — lets new customers pick the group when they sign up.
    3. Main on site — the group assigned by default on the storefront.
    ColumnWhat it does
    “On site”the group is exported to the site as a customer group; its name comes from the “Name” column and is the same for all site languages (up to 32 characters on the site)
    “At registration”a shopper can choose this group when registering on the site; available only for an “On site” group
    “Main on site”the default group: new shoppers and site guests are in it. Only one group can be main — the mark on another group is cleared automatically

    Once you mark “Main on site”, the group also becomes “On site”. On the first export the main group isn't created anew: the group that's already the default on the site becomes it and gets your name.

    What prices groups get on the site

    For each “On site” group, the export sends the prices set in Elbuz for that specific contact group: those applied by promotion and discount rules or entered in the product card. There are two kinds:

    • quantity discounts — the price when a shopper buys N units or more;
    • group sale prices with start and end dates.

    The main group's promotion is, as before, the “Sale price” from the product card. Prices go only for products exported in this run: after changing the rules, run a catalog export.

    What happens if you clear “On site”

    The group stays on the site — it may have shoppers and loyalty levels — but it disappears from the registration choice and loses its prices. Groups created directly in the site admin aren't touched by the export.

    You can't assign a group to a specific site shopper from Elbuz: that's done in the store admin, or the shopper picks a group themselves during registration.

    Customer stages: the “Contact Statuses” directory

    A customer stage isn't a sales step but where the person stands with you now: lead, customer, regular, dormant. Sales are tracked separately, by an order or a deal with its own steps (what's the difference). Stages live in the “Contact Statuses” directory: the gear by the card's “Customer stage” field (tooltip “Open status directory”) opens the “Statuses” window.

    Seven customer stages
    StageWho sets itWhen
    Leada manager; the program — for new recordsthe person wrote, called or left a cart but hasn't bought yet
    Qualifieda manager; the program — when a deal is opened for a leadonly in wholesale and services: interest is confirmed, talks are under way
    Customerthe programfirst purchase under the business format's rule, or a won deal
    Regularthe programrepeat purchases: 3+ orders (in services — 2+ paid periods)
    Dormantthe programa pause longer than the format's threshold: 90 days, 120 in wholesale, two payment intervals in services
    Lostthe programover a year with no purchase
    Not a fita managerrefusal, spam, “not our customer”; the very first purchase moves it to “Customer”

    The business format doesn't delete anything; it only turns on the stages you need: online stores and pickup points have “Qualified” turned off, because there you become a customer with the first order.

    Old stages — “In progress”, “Presentation”, “Commercial proposal”, “Negotiations”, “Important”, “Urgent” and others — remain in the directory, turned off. “New” became “Lead”, and “Qualification” became “Qualified”.

    Buyers who were in those two stages got a stage based on their purchases, and records from “Qualification” with no purchases or deals got “Lead”. Suppliers and competitors had their stage removed. If you were already running your own funnel in the directory, it wasn't rewritten.

    You can still rename a stage, change the column order and clear “Activity” in the directory. But after you change the directory yourself, the program stops switching stages by business format: changing the business format will show “Business format saved; your own stage settings were kept”.

    Add your own stage with “+”. It counts as manual, like “Lead” or “Not a fit”: the card field, “Stage” bulk action and “Stages” board offer it, and an AI employee can set it. Like other manual stages, it can't go on a buyer: the program calculates their stage. Built-in stages can't be deleted: the row returns after a grid refresh.

    The “Color” column in the stage grid is shown, but color changes aren't saved: after a grid refresh the previous one comes back.

    How to add a contact source

    Where the customer came from: website, Prom, Rozetka, Epicentr, a referral, a trade show. Add a new source in the directory itself: “Contacts” list menu → “References” → “Contact sources” → “+”, type the name, Enter. It then appears in the source field of the card's “Marketing” section, the “Source” filter above the list and the “Sources” block of analytics.

    This directory isn't about price lists or marketplaces — it's just a card mark. Don't confuse it with “New source” in the “Price lists” window, which adds a price list or a supplier website , not a contact source.

    For customers the program created by itself, the source is filled in automatically: “Chat (web)”, “Chat (telegram)” and other channels — from chat, “Email (AI)” — from an email parsed by AI, “Call” — from the AI analysis of a phone call. So the “Source” filter shows how many customers came through each channel without manual entry.

    Departments, positions and role in purchase

    “Departments and divisions” and “Positions and roles of employees” are the lists for the “Department / Division” and “Position” fields in the card's “Overview”. Positions also have a “Group” column to sort positions by area.

    Who decides what at the customer's company isn't marked by position but by a separate field, “Role in purchase”, in the “Overview” of a contact person's card. There are six values: “Decision maker”, “Influences the decision”, “Finance, payment” — for the accountant, “Technical contact”, “Product user”, “Objects, blocks the deal”.

    The list is fixed; you can't add your own values. The role shows next to the name among the organization's contact persons in the preview pane, so it's clear at once whom to call about the decision and whom about payment.

    Ownership forms: what goes into documents

    “Contacts” list menu → “References” → “Ownership forms”. An entry has three text fields: “Name” (Товариство з обмеженою відповідальністю, limited liability company), “Short name” — the abbreviation (ТОВ, LLC) — and “Group” (business companies, individuals, enterprises, cooperatives…). The card's “Ownership form” field in the “Company” section shows only active entries, alphabetically.

    What goes into documents. In print templates, the {Contractor: Legal form} macro inserts the entry's “Name” — the full one; “Short name” doesn't go to print.

    To get «ТОВ» on the invoice, either type «ТОВ» into this ownership form's “Name”, or skip the ownership form macro and write the short form in the contact's name — ТОВ «Ромашка» in the “Full name” field — and insert that field's macro into the template. More on macros in the article on print templates.

    Ukrainian and Polish separately. “Group” is free text: type “Ukraine” for Ukrainian forms and “Polska” for Polish ones, then filter or sort the directory by it. The card's choice list isn't split by group — it's alphabetical. To hide Polish forms, clear their “Activity”: they leave the card field but stay in the directory.

    The “Countries, cities” directory

    It opens from the contact list menu: the “References” section → “Countries, cities”. The country grid is at the top, and below it are the cities of the selected country. The directory already contains the world's countries, including Ukraine and Poland, so you rarely need to add a country: find it with the filter on the “Country” column.

    Country columns: “Activity”, “Country”, “ISO 2”, “ISO 3”, “Default”, “Address format”, “Postcode required”, description and dates. Here's what is saved when you edit a cell with a double-click:

    • Saved: “Activity”, name, description and “Default”. Only one country can have the “Default” flag: set it for Ukraine, and it's cleared from the country that had it.
    • Not saved: “ISO 2”, “ISO 3”, “Address format” and “Postcode required”. You can change the cell, but after a grid refresh the old value is back. You can't make the postcode required for Poland in this window.

    The “Add” button creates a new country with a name only; its ISO codes and address format stay empty.

    Country in the contact card. The country and city in the “Address” section are picked from the program's built-in geographic directory, not from this list. So the “Default” flag here doesn't put Ukraine into a new card, and cards have no separate “default country” setting: you pick the country by typing its name in the field.

    Why a directory says “Not enough permissions for this operation!”

    Each directory is a separate window, and users get access to it through their group: it's granted separately in “Group permissions”, by window name: “Contact groups”, “Contact Statuses”, “Lead sources”, “Company departments”, “Employee positions and roles”, “Industries”, “Legal forms”. Without access, an access-denied screen opens instead of the grid.

    If access was removed while the directory window was open, the server rejects every edit, and it shows in different ways:

    • a new row silently isn't saved and disappears after a grid refresh;
    • a cell edit ends with “Update failed”;
    • a deletion ends with “Not enough permissions for this operation!”.

    The cause is the same: your user group has no access to this window — for example, to “Company departments”. Permissions for “Organizational structure” don't matter here. An administrator opens “Group permissions”, finds your group and grants access to the window, and you close and reopen the directory — how permissions are granted is in the article on group permissions.

    What to do when a directory doesn't save a change

    What the program says and what to do about it
    What you seeWhyWhat to do
    “Not enough permissions for this operation!” or “Update failed” in the departments directory the user's group has no access to the “Company departments” window an administrator grants access to this window in “Group permissions” (directory permissions)
    A new group doesn't show in the price list tree the group doesn't have “Show in Price lists” ticked, or it has no active contacts tick the checkbox in the group grid, move the supplier to this group and check its “Activity” (contact groups)

    FAQ

    How do I make Ukraine the default country?

    In the contact card — you can't: the country there is picked from the built-in geographic directory, and there's no “default country” setting. The “Default” flag in “Countries, cities” is saved but doesn't fill in the card.

    How do I add Poland with a required postcode for delivery?

    Poland is already in the “Countries, cities” directory — find it with the filter on the “Country” column. You can't make the postcode required: that column isn't saved in the window (countries, cities).

    Can I give the VIP group a color so it stands out?

    Yes: double-click the “Color” cell in the group's row to open the palette. The color shows as a role chip in the contact list and as a mark in the price list tree. Add the VIP group itself with the “+” button (groups).

    Where do I set a company's business area — retail, manufacturing?

    In the card, “Company” section, “Business area” field. If a value is missing, add it to the “Business areas” directory with the “+” button and leave “Activity” on, otherwise the card won't offer it.

    Why isn't a stage color saved?

    The “Color” column in the stage grid is display-only: after a grid refresh the previous color comes back. The color you see in the contact list is the role color from “Contact groups”.

    How do I change the order of stages on the board?

    With the “Sort Order” column in “Contact Statuses”. After you change the directory yourself, the program stops switching stages by business format (stages).

    Where to find them and who has access

    Menu
    Directories → Contacts → Account groups
    Other directories
    the “Contacts” list menu → “References”
    Stages
    the gear next to the “Customer stage” field in the card
    Access right
    each directory has its own window in “Group permissions” (below)

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free