Manage your sales pipeline from lead capture to deal close using Mosic’s CRM. The CRM module covers leads, customers, contacts, organizations, and deals through configurable sales pipelines.
CRM Overview
Mosic’s CRM helps you track every stage of your sales process. You can capture leads, qualify them, convert them into customers, and track deals through custom pipelines.
The CRM includes five record types:
- Leads — Potential customers you want to qualify
- Customers — People or organizations you do business with
- Contacts — Specific people linked to customers
- Organizations — Companies that customers belong to
- Deals — Sales opportunities tracked through pipelines
Leads
A lead represents a potential customer. Leads move through a status workflow until they are qualified, converted, or marked as lost.
Creating a Lead
You need a workspace before you can create leads.
- Open the CRM section in the sidebar
- Navigate to the Leads page
- Click the create button to open the lead creation dialog
- Enter a Title
- Fill in optional fields: Email, Phone, Company, Source
- Click Save
The lead starts with New status and a score of 0.
Lead Status Workflow
Leads move through five statuses:
- New — Just captured, not yet contacted
- Contacted — Initial outreach has been made
- Qualified — Meets your criteria for a real opportunity
- Converted — Turned into a customer (requires the conversion dialog)
- Lost — No longer a viable opportunity (requires a lost reason)
You can set the status directly using the status selector in the lead detail view. Converted and Lost require their own dedicated dialogs and cannot be set from the status selector.
You can record calls, emails, meetings, and notes directly against a lead using the Log Activity button in the Recent Activity card on the lead detail page. See Activity Log for a step-by-step walkthrough.
Lead Scoring
Every lead has a numeric score from 0 to 100. The score is displayed as a tier label and progress bar in the Lead Score section of the lead detail view.
| Tier | Score Range | Meaning |
|---|---|---|
| Hot | 80–100 | High-priority, ready to engage |
| Warm | 50–79 | Promising, needs nurturing |
| Cold | 0–49 | Low priority, early stage |
The score tier icon appears in the lead header for quick identification.
Converting a Lead
A lead must have Qualified status before you can convert it.
- Open a qualified lead
- Click the Convert button in the header
- The Convert Lead to Customer dialog opens
- Review the warning: this action cannot be undone
The conversion dialog has two sections:
Create Customer (Required)
- Enter a Customer Name (required)
- Choose a Customer Type: Individual or Organization
- Fill in Email and Phone (pre-filled from the lead)
- Optionally link an Organization
- Optionally assign an Owner
Create Deal (Optional)
Check the Create Deal checkbox to add a deal at the same time.
- Enter a Title (required if checkbox is enabled)
- Select a Pipeline and Stage
- Enter a Value and Currency (USD, EUR, or GBP)
- Set an Expected Close Date
Click Convert Lead to complete the conversion. The lead becomes read-only with Converted status. A new customer record is created. If you chose to create a deal, that record is also created.
Marking a Lead as Lost
You can mark a lead as lost from any status except Converted.
- Open the lead
- Click the Mark Lost button in the header
- Search for and select a Lost Reason from existing reasons, or describe a new one by entering a Title
- Optionally add a Description with details
- Click Mark as Lost
The lead status changes to Lost and the reason appears in the lead detail view.
Lead Fields
| Field | Type | Required | Description |
|---|---|---|---|
| Title | Text | Yes | Name or description of the lead |
| No | Primary email address | ||
| Phone | Phone | No | Primary phone number |
| Company | Text | No | Company name the lead belongs to |
| Source | Dropdown | No | How the lead was found |
| Status | Dropdown | No | Current stage in the lead workflow |
| Score | Number | No | Numeric value from 0 to 100 |
| Description | Rich text | No | Notes and context about the lead |
| Organization | Link | No | Linked customer organization |
| Related Contact | Link | No | Linked customer (individual contact) |
Source options: Website, Referral, Cold Call, Advertising, Social Media, Event, Partner, Email Campaign, Other
Lead views support both list and board layouts. Switch between them using the view toggle on the Leads page.
Customers
Customers are the people or organizations you do business with. Every deal, contact, and support ticket links back to a customer.
Creating a Customer
- Open the CRM section in the sidebar
- Navigate to the Customers page
- Click the create button to open the customer creation dialog
- Enter a Customer Name
- Choose a Customer Type: Individual or Organization
- Fill in optional fields: Email, Phone, Source
- If the customer type is Individual, you can link an Organization
- Optionally assign an Owner
- Click Save
New customers start with Active status.
Customer Types
| Type | Description |
|---|---|
| Individual | A single person. Can be linked to an organization. |
| Organization | A company or business entity. |
Customer Detail View
The customer detail page uses a three-column layout.
Left sidebar contains sections for:
- Contact Info — Email, phone, secondary email, secondary phone
- Social — LinkedIn, Twitter/X, website links
- Organization — Linked organization card
- Contacts — List of contacts for this customer with an Add Contact button
- Source — Where the customer came from
- Visibility — Access control setting
- Tags — Labels for categorization
- Details — Created date, modified date, created by
Main area shows:
- KPI cards with key metrics
- Description — Rich text notes about the customer
- Attachments — Files and documents
Right sidebar has tabs for:
- Comments — Team discussion with reactions and revisions
- Notes — Internal notes about the customer
- Activity — Timeline of all changes
- Work — Related tasks
- Deals — Linked deal records
- Tickets — Linked support tickets
- Contacts — Contacts for this customer
- Relations — Links to other documents
Customer Statuses
| Status | Description |
|---|---|
| Active | Current customer in good standing |
| Inactive | Customer is no longer active |
| Churned | Customer has left, with an optional Churn Reason |
Customer Fields
| Field | Type | Required | Description |
|---|---|---|---|
| Customer Name | Text | Yes | Full name or organization name |
| Customer Type | Dropdown | No | Individual or Organization |
| No | Primary email address | ||
| Phone | Phone | No | Primary phone number |
| Secondary Email | No | Additional email address | |
| Secondary Phone | Phone | No | Additional phone number |
| Source | Dropdown | No | How the customer was acquired |
| Organization | Link | No | Linked organization (Individual customers only) |
| Status | Dropdown | No | Active, Inactive, or Churned |
| Description | Rich text | No | Notes about the customer |
| URL | No | LinkedIn profile URL | |
| Twitter/X | URL | No | Twitter or X profile URL |
| Website | URL | No | Website URL |
| Churn Reason | Text | No | Reason for churn (visible when status is Churned) |
| Is Archived | Check | No | Marks the customer as archived |
Contacts
Contacts are specific people linked to a customer. Each customer can have multiple contacts, with one marked as the primary contact.
Creating a Contact
You need an existing customer before you can create a contact.
- Open a customer detail page
- Click + Add Contact in the Contacts section
- Select or confirm the Customer (required, pre-filled)
- Fill in optional fields: Email, Phone, Job Title
- Click Save
You can also create contacts from the CRM sidebar.
Contact Detail View
The contact detail page shows contact information, linked customer, and related activity in a three-column layout.
Contact Fields
| Field | Type | Required | Description |
|---|---|---|---|
| Full Name | Text | Yes | Full name of the contact |
| Customer | Link | Yes | The customer this contact belongs to |
| No | Email address | ||
| Phone | Phone | No | Phone number |
| Job Title | Text | No | Role or title at the organization |
| Portal User | Link | No | Link to portal user for customer self-service access |
| Is Primary | Check | No | Marks this as the primary contact for the customer |
Organizations
Organizations represent companies that customers can be linked to. They support a parent-subsidiary hierarchy.
Creating an Organization
- Open the CRM section in the sidebar
- Navigate to the Organizations page
- Click the create button to open the organization creation dialog
- Enter an Organization Name (required)
- Fill in optional fields: Industry, Company Size, Website
- Optionally select a Parent Organization
- Click Save
Parent-Subsidiary Hierarchy
Organizations can have a parent organization. This creates a company hierarchy where a subsidiary links up to its parent. Set the Parent Organization field when creating or editing an organization. Choose None (Root Organization) for top-level companies.
Organization Fields
| Field | Type | Required | Description |
|---|---|---|---|
| Organization Name | Text | Yes | Name of the organization |
| Industry | Dropdown | No | Industry sector |
| Company Size | Dropdown | No | Number of employees |
| Website | URL | No | Organization website |
| Parent Organization | Link | No | Parent company in a hierarchy |
| Annual Revenue | Currency | No | Annual revenue of the organization |
Deals
Deals represent sales opportunities tracked through a pipeline. Each deal has a value, a stage, and a linked customer.
Creating a Deal
- Open the CRM section in the sidebar
- Navigate to the Deals page
- Click the create button to open the deal creation dialog
- Enter a Title
- Select a Pipeline (required)
- Choose a Stage from the selected pipeline
- Optionally link a Customer
- Set a Value
- Optionally set an Expected Close Date
- Click Save
If a default pipeline is configured, it is selected automatically.
Pipeline Board View
The deals page has a board view that shows deals organized by pipeline stage. Each stage appears as a column. Deal cards show the title, value, customer, and assignees.
You can drag and drop deal cards between columns to change their stage. The Win Probability updates automatically based on the new stage’s probability setting.
Deal Status
Deals have three statuses:
| Status | Description |
|---|---|
| Open | Active deal moving through the pipeline |
| Won | Successfully closed |
| Lost | Deal was lost to a competitor or other reason |
Marking a Deal as Won or Lost
Use the actions menu on a deal to mark it as Won or Lost.
Marking as Won:
- Open the deal
- Select Mark as Won from the actions menu
- Set the Close Date
- Optionally update the Final Value if it differs from the original estimate
- Select the Won Stage if the pipeline has more than one
- Click Mark as Won
Marking as Lost:
- Open the deal
- Select Mark as Lost from the actions menu
- Select a Lost Reason from existing reasons, or create a new one
- Add details in the Title and Details fields
- Optionally name a Competitor
- Set the Lost Date
- Select the Lost Stage if the pipeline has more than one
- Click Mark as Lost
Use the Log Activity button in the Recent Activity card on any deal detail page to capture calls, demos, meetings, and other interactions. Activities logged on a deal are also visible in the linked customer’s feed. See Activity Log for full details.
Reopening a Deal
Won or lost deals can be reopened.
- Open a won or lost deal
- Click the Reopen button in the header
- If the deal was on a Won or Lost stage, select the stage to reopen into
- Confirm the action in the reopen dialog
The deal status returns to Open, the close date is cleared, and it reappears in the pipeline board.
Deal Detail View
The deal detail page uses a three-column layout.
Left sidebar contains:
- Customer — Linked customer, organization, and contact
- Assignees — Team and assigned users
- Pipeline — Current pipeline and win probability bar
- Value — Deal value, probability, weighted value, and currency
- Dates — Expected close, stage entered, days in stage, deal age
- Source — Deal source
- Visibility — Access control setting
- Details — Owner, created date, modified date, created by
Main area shows:
- KPI cards
- Description — Rich text notes about the deal
- Lost reason section (for lost deals)
- Attachments
Right sidebar has tabs for:
- Comments — Team discussion
- Notes — Internal notes
- Activity — Change timeline
- Work — Related tasks
- Tickets — Linked support tickets
- Relations — Links to other documents
Deal Fields
| Field | Type | Required | Description |
|---|---|---|---|
| Title | Text | Yes | Name of the deal |
| Pipeline | Dropdown | Yes | Which pipeline the deal belongs to |
| Stage | Dropdown | No | Current stage within the pipeline |
| Customer | Link | No | Linked customer record |
| Value | Number | No | Monetary value of the deal |
| Currency | Dropdown | No | USD, EUR, or GBP |
| Probability | Number | No | Win probability percentage (set by stage) |
| Expected Close Date | Date | No | Anticipated closing date |
| Source | Dropdown | No | Where the deal originated |
| Description | Rich text | No | Notes and context |
| Status | Dropdown | No | Open, Won, or Lost |
| Source Lead | Link | No | The lead this deal was created from |
Deals can be flagged as stalled when they have not progressed for a configurable number of days. The Is Stalled indicator appears on the deal when the inactivity threshold is exceeded.
Pipelines and Stages
Pipelines define the stages that deals move through. Each workspace can have multiple pipelines, but only one can be the default.
Creating a Pipeline
You need admin or editor access to manage pipelines.
- Open Settings from the sidebar
- Navigate to Sales Pipelines
- Click Create Pipeline
- Enter a pipeline name and optional description
- Add stages (see below)
- Save the pipeline
Adding and Configuring Stages
Each pipeline can have multiple stages. To add a stage:
- Open a pipeline in the settings page
- Click Add Stage
- Enter a Stage Name (required)
- Set a Probability percentage using the slider (0–100%)
- Choose a Color for the stage indicator
- Optionally mark the stage as a Won Stage or Lost Stage
- Click Add Stage
Each pipeline can have at most one Won Stage and one Lost Stage. A stage cannot be both won and lost at the same time.
The probability represents the likelihood of closing a deal at that stage. It drives the Weighted Value calculation shown on deal detail pages.
Setting a Default Pipeline
When you create a deal, the default pipeline is selected automatically. To set a default:
- Open Settings and navigate to Sales Pipelines
- Open the pipeline you want as default
- Enable the Default toggle
- Save the pipeline
Only one pipeline per workspace can be the default. Setting a new default removes the default flag from the previous one.
Record Visibility
Every CRM record (lead, customer, contact, deal) has a visibility setting that controls who can access it.
| Visibility | Description |
|---|---|
| Workspace | All workspace members can see the record (default) |
| Team | Only members of the assigned team can see the record |
| Private | Only you can see the record |
Change visibility using the Visibility selector in the detail view. When you set visibility to Team, you must also select a team. The Team field is required in that case.
Visibility also affects who can be assigned to a record. When visibility is Team, only team members appear in the assignee list.
Views and Navigation
List View
The CRM section in the sidebar provides access to all record types. Each list view shows records with key fields and supports sorting and filtering.
Board View
The Deals page offers a board view. Deals appear as cards in columns organized by pipeline stage. Drag cards between columns to update the stage.
Detail Pages
Click any record to open its detail page. The three-column layout shows metadata on the left, main content in the center, and collaboration tabs on the right.
Bulk Operations
You can perform actions on up to 100 records at once from list views. Select multiple records using the checkboxes, then choose an action from the bulk actions toolbar.
Available bulk actions vary by record type and may include updating status, changing owner, or deleting records.
Permissions
CRM DocTypes use workspace-level role-based access control. Roles (Admin, Editor, Member, Viewer, Guest) are assigned at the workspace level. Private records are only visible to their owner.
Best Practices
- Qualify leads before converting — Only convert leads that meet your qualification criteria
- Use lead scoring — Keep scores updated so hot leads stand out
- Set up a default pipeline — New deals automatically use it
- Track lost reasons — Help your team learn from lost deals
- Link contacts to customers — Every contact should belong to a customer
- Use organizations for companies — Keep customer records clean by linking them to organizations
- Assign owners — Every record should have a clear owner
- Add descriptions — Provide context on deals and leads for your team
- Use tags — Categorize records for easier filtering
- Set expected close dates — Help forecast revenue accurately
Troubleshooting
Cannot create a lead or customer
Make sure you are in a workspace. You need at least Member role to create CRM records.
Cannot convert a lead
The lead must have Qualified status. The Convert button only appears on qualified leads.
Deal does not appear in the board view
Check that the deal is assigned to the correct pipeline. Deals with Won or Lost status do not appear in the active board view.
Cannot change a lead or deal status
Converted and Lost statuses for leads require their own dialogs. Won and Lost statuses for deals also require the dedicated dialog. Use the Convert, Mark Lost, or Mark as Won actions instead.
Cannot assign a user to a record
If the record has Team visibility, only team members can be assigned. Change the visibility to Workspace to see all workspace members, or add the user to the assigned team.
Pipeline stages not showing
Make sure the pipeline has stages configured. Open Settings and navigate to Sales Pipelines to add stages.
Related Documentation
- Relations & Links — Link CRM records to other documents
- Permissions & Roles — Detailed permission model
- Teams & Invitations — Manage teams for record visibility