Editoral style
This page outlines the rules and recommendations for grammar, punctuation, word choice, and formatting to ensure clear, consistent, and on-brand content.
Last updated
Was this helpful?
This page outlines the rules and recommendations for grammar, punctuation, word choice, and formatting to ensure clear, consistent, and on-brand content.
Last updated
Was this helpful?
We follow a few trusted external style resources to ensure our content is clear, consistent, and user-centered:
: Our primary reference, which adopts AP style with specific exceptions tailored to federal websites.
: We follow USWDS guidance for content within design components, such as using sentence case for buttons and form elements.
: These federal plain language guidelines serve as our foundation for writing in a way that’s clear, concise, and accessible to all users.
Consistent use of pronouns is key to creating a clear and cohesive editorial perspective. Switching between first-person ("my account") and second-person ("your account") can confuse users and disrupt the flow of communication. We use the second person (e.g., "your account") throughout the product to maintain a consistent, user-focused voice. This approach reinforces clarity, reduces ambiguity, and aligns with how most users think about interacting with a product from their perspective.
Using contractions (like we're', it's' or you'll) helps our writing sound more natural, approachable, and human, just like how people speak in everyday conversation. They soften overly formal language, making our content feel more friendly and accessible, especially in user-facing experiences. By using contractions, we create a tone that’s warm, relatable, and easier to connect with.
Simpler.Grants.gov uses sentence case in most cases. Sentence case makes content easier to scan and digest, especially in long text. It also aligns with how many people naturally speak and write, making it feel more conversational. In contrast, excessive use of title case can engender formality, making our product look stiff and unwelcoming. Sentence case examples
H2 and lower
Column headers
Labels and other UI components
Progress indicator labels
Modal titles
Buttons (per )
Title case examples
Page titles
H1 headings
The subject line for Simpler.Grants.gov newsletters
It follows a format where "[Month] Updates" uses title case, while the latter portion after the pipe symbol uses sentence case. Example: "May Updates | Building momentum with every release"
Uppercase examples
Opportunity statuses. Examples: CLOSING, OPEN.