# voice.md

## Communication Style

### Overall tone and personality
Shippo's voice is **professional yet approachable**, **confident**, and **empowering**. We aim to be seen as a **reliable partner** and an **expert guide** in e-commerce shipping. Our tone is primarily **solution-oriented** and **benefit-driven**, focusing on how we simplify complex processes for our users. We are **efficient** and **direct**, valuing clarity and actionable insights.

### Key stylistic elements and patterns
*   **Direct Address:** We frequently use "you" and "your" to speak directly to our audience, fostering a sense of partnership and relevance.
*   **Benefit-First Messaging:** Headlines and introductory paragraphs emphasize the positive outcomes for the user before detailing features.
*   **Action-Oriented Language:** We use strong verbs and imperative phrasing to encourage engagement and highlight functionality.
*   **Clarity and Conciseness:** Sentences are generally short, clear, and to the point, avoiding unnecessary jargon or fluff.
*   **Problem/Solution Framing:** We often identify common shipping challenges and immediately present Shippo as the effective solution.
*   **Use of Lists and Bullet Points:** For readability and quick information absorption, especially when detailing features or benefits.
*   **Data-Informed Confidence:** When relevant, we hint at the robust data and technology behind our solutions (e.g., "powered by machine learning trained on millions of real shipments").

### Vocabulary preferences and word choices
*   **Keywords:** Shipping, e-commerce, logistics, labels, rates, carriers, integrations, API, solutions, scalable, seamless, efficient, accurate, automate, streamline, insights, powerful, flexible, tools.
*   **Positive Adjectives:** Best, world-class, seamless, accurate, easy-to-use, developer-friendly, premier, custom, deep (discounts).
*   **Action Verbs:** Ship, power, handle, integrate, connect, leverage, enhance, speed, focus, print, generate, schedule, cut (costs), convert (shoppers).
*   We aim for language that is accessible to both small business owners and technical developers, providing context for any necessary technical terms.

## Content Patterns

### Common themes and topics
*   **Simplifying Shipping:** Making shipping easy, fast, and stress-free for businesses of all sizes.
*   **Cost Savings:** Highlighting access to discounted rates and tools that reduce shipping expenses.
*   **Efficiency & Automation:** Emphasizing time-saving features, automated workflows, and streamlined processes.
*   **Scalability & Flexibility:** Showcasing Shippo's ability to grow with businesses, whether through the app or API.
*   **Comprehensive Solutions:** Covering a wide range of needs, from integrations and carriers to tracking and international shipping.
*   **Reliability & Support:** Reinforcing trust through accurate information and dedicated customer assistance.
*   **E-commerce Insights:** Providing valuable educational content, guides, and industry reports.
*   **Product Updates:** Announcing new features and improvements with clear benefits.

### Structural approaches to content
*   **Audience Segmentation:** Content is often tailored to specific user groups (SMBs, high-volume shippers, software providers).
*   **Feature/Benefit Showcases:** Presenting a feature and immediately following with its direct benefit to the user.
*   **Educational Guides:** Step-by-step instructions or comprehensive explanations for shipping processes.
*   **Comparative Analysis:** Offering comparisons of carriers or shipping methods to aid decision-making.
*   **Quick Overviews:** Summarizing complex topics into easily digestible points.

### Call-to-action styles and patterns
Our CTAs are **clear, concise, and strategically placed**. They often appear at the end of sections or after a key value proposition.
*   **Direct & Actionable:** "Get started," "Learn more," "Contact an expert," "Explore API docs," "Contact sales," "Join."
*   **Benefit-Oriented (implied):** While direct, the preceding content makes the benefit of clicking obvious.
*   **Varied:** CTAs are adapted to the user's stage in their journey (e.g., "Get started" for new users, "Contact sales" for enterprise solutions).

## Audience Interaction

### How the brand addresses its audience
We address our audience directly using "you" and "your," positioning ourselves as a helpful tool and partner. We speak with an understanding of their challenges and aspirations, aiming to provide solutions that empower them to focus on their core business.

### Level of formality and relationship style
The relationship is **professional and respectful**, but also **supportive and encouraging**. We avoid overly stiff or corporate language, opting for a tone that is knowledgeable and trustworthy, yet accessible. We're a guide, not just a vendor.

### Engagement and conversation patterns
Our communication is primarily informative and persuasive. While blog content might lean slightly more towards engaging education, the overall pattern is one of delivering valuable insights and solutions rather than initiating casual conversation. We aim to answer questions before they're asked and guide users to the best solutions.

## Guidelines & Examples

### Do's and don'ts for brand communication

**Do's:**
*   **Be clear and concise:** Get to the point quickly and efficiently.
*   **Focus on benefits:** Always explain *why* a feature matters to the user.
*   **Use active voice:** Keep sentences dynamic and direct.
*   **Empower the user:** Frame Shippo as a tool that helps them succeed.
*   **Provide actionable advice:** Offer practical steps or insights.
*   **Maintain a confident and knowledgeable tone:** Position Shippo as an industry leader.

**Don'ts:**
*   **Be vague or ambiguous:** Avoid unclear language or generalizations.
*   **Use excessive jargon without explanation:** If a technical term is necessary, clarify its meaning.
*   **Sound overly corporate or stiff:** Maintain an approachable, human element.
*   **Overpromise or exaggerate:** Be honest and realistic about capabilities.
*   **Use passive voice frequently:** It can make content sound less direct and authoritative.

### Example phrases and expressions that are "on-brand"
*   "Your one-stop solution for shipping labels."
*   "Speed through your shipping with easy-to-use tools and deep discounts."
*   "Focus on your business, not on shipping."
*   "Connect your stores, get the best rates from 40+ global carriers, and quickly print labels."
*   "Powered by machine learning trained on millions of real shipments, so you can promise accurate delivery dates."
*   "Not Another Corporate Blog—Only The Best E-commerce Insights. Delivered On Time."
*   "Stop piecing together pick lists by hand. Generate a pick list in seconds."

### Content types and formats the brand uses
*   **Blog Posts:** Educational guides, industry insights, news, product updates, customer stories.
*   **Marketing Copy:** Website landing pages, solution overviews, value propositions.
*   **Product Descriptions:** Detailed explanations of features, benefits, and use cases for app and API.
*   **Resources:** E-books, case studies, webinars, tutorials, calculators, Shippopedia (glossary).
*   **CTAs:** Buttons and links for "Get started," "Learn more," "Contact sales," etc.