When a merchant or client finds your profile in the Meridian directory and wants to work with you, they submit a contact form directly on your public profile page. Meridian captures that submission as aDocumentation Index
Fetch the complete documentation index at: https://help.the-meridian.ai/llms.txt
Use this file to discover all available pages before exploring further.
ContactFormSubmission, routes it according to rules you define, and tracks every inquiry through a status workflow until it’s resolved. The result is a lightweight CRM for inbound developer leads — built into the same platform where you manage your apps, deployments, and certifications.
Contact form submissions
Every inquiry sent through your public profile becomes aContactFormSubmission with the following fields:
| Field | Description |
|---|---|
from | The sender’s name |
email | Their contact email address |
company | Their company name (optional) |
message | The inquiry text |
submittedAt | ISO timestamp of when the form was submitted |
status | Current state in the workflow: new, read, replied, or archived |
new badge so you never miss an inbound inquiry.
Submission workflow
Move each inquiry through a clear lifecycle to keep your inbox clean and your response rate high.new
The submission has just arrived. You haven’t opened it yet. Meridian highlights unread submissions so they stand out.
replied
You’ve responded to the merchant or client. This is the state you should aim to reach for every qualified lead.
Lead generation stats
TheContactFormStats object gives you a real-time view of your form’s performance.
| Metric | Description |
|---|---|
totalSubmissions | Cumulative submissions received through your profile |
conversionRate | Share of profile visitors who submit the contact form (0–1) |
avgResponseTime | Your average time to reply, in hours |
submissionsOverTime | Array of { date, count } for trend visualization |
conversionRate alongside your profile’s pageViews and uniqueVisitors (from your public profile) to understand how well your profile converts traffic into leads.
Monthly lead metrics
The top of the Leads dashboard shows high-level stats for the current period:| Metric | Description |
|---|---|
totalLeadsThisMonth | Total new submissions received in the current calendar month |
growthLeadsThisMonth | Growth vs. the previous period as a percentage (e.g., 12 = +12%, -0.8 = -0.8%) |
growthConversionRate | Change in your conversionRate vs. the previous period |
growthAvgResponseTime | Change in your avgResponseTime — a negative value means you’re responding faster |
growthFeaturedPlacements | Change in impressions or clicks from featured placement slots |
growthLeadsThisMonth with a stable or improving growthConversionRate means both more traffic and better conversion — the ideal combination.
Inquiry routing
As your lead volume grows, use inquiry routing to automatically send submissions to the right team member or email address without manually reading every message first. EachInquiryRoute defines a rule:
| Field | Description |
|---|---|
name | A label for the rule (e.g., “Enterprise inquiries”) |
condition | Match logic, e.g., "contains 'enterprise'" or "contains 'Plus'" |
routeTo | The email address or team member the submission is forwarded to |
matchCount | How many inquiries have matched this rule so far |
isActive | Whether the rule is currently running |
- Creating a route
- Example routing rules
Add a rule
Click New rule. Give it a name, write a condition using keyword matching (e.g.,
"contains 'urgent'"), and set a routeTo email address.Featured placements for lead generation
Featured placements let you pay for priority visibility in specific directory slots, driving more profile visits and — by extension — more form submissions. EachFeaturedPlacement tracks:
| Field | Description |
|---|---|
position | The placement slot (e.g., "directory-top", "category-sidebar") |
impressions | Times your profile was shown in this slot |
clicks | Clicks from the placement to your profile |
ctr | Click-through rate (clicks / impressions) |
cost | Cost per period for the placement |
cost by the number of submissions you receive during the same period. Compare that against the value of a typical engagement to evaluate whether a placement is worth renewing.
Responding to inquiries
When you open a submission, move it through the status workflow as you act on it.Read the submission
Open the submission to change its status from
new to read. Review company, message, and email to qualify the lead.Reply
Respond via email (Meridian surfaces the
email field). Once you’ve sent your response, mark the submission as replied. This updates your avgResponseTime stat.Tips for writing a profile that converts visitors to leads
A well-optimized profile generates more submissions from the same traffic. Focus on these areas:Write a specific tagline
Write a specific tagline
Vague taglines like “Shopify developer” don’t convert. Specific ones do: “Shopify subscription billing developer with 10+ published apps.” Visitors who self-select based on your specialization are more likely to submit a form.
Show your best app first
Show your best app first
The first
ShippedApp in your list anchors a visitor’s impression of your work. Lead with the app that has the highest installs or rating to establish credibility immediately.Display public testimonials
Display public testimonials
Set
isPublic: true on your strongest Testimonial entries. Social proof directly before the contact form consistently raises conversionRate.Earn a higher verification level
Earn a higher verification level
Profiles at
verified or trusted-partner level show trust indicators that reduce visitor hesitation. See Build your public developer profile for the verification steps.Reduce your response time
Reduce your response time
Your
avgResponseTime is visible to visitors. A response time under 24 hours signals professionalism and increases form submission rates. Set up inquiry routing so every submission reaches the right person immediately.Use featured placements to test messaging
Use featured placements to test messaging
Run a featured placement for 30 days, then compare
ctr and conversionRate against the preceding period. If ctr is high but conversionRate is low, visitors are interested but not convinced by your profile — revise your description or add testimonials.