Skip to main content

FutureLink Barcelona (6-8 October) is now open for registration. Sign up today!

Close

Amadeus

AI
Home
Clear Search
User Log In
  • Tracelink Classic
    TraceLink Classic app.tracelink.com
    Redirect
  • Opus Platform
    Opus Platform opus.tracelink.com
    Redirect
  • Supply Chain Orchestrations
    Left fast
    Supply Chain Orchestrations
    • Life Sciences Company

      Life Sciences Company

      Life sciences companies face distinct challenges in orchestrating supply chains with partners. TraceLink specializes in addressing and overcoming these challenges.
      Learn More
      Left fast
      Life Sciences Company
      • Orchestrating the supply chain
        • Life Sciences Company
        • Direct Material Supplier
        • Contract Manufacturer
        • Third Party Logistics
        • Wholesale Distributor
        • Healthcare Provider
        • Retail Pharmacy

      Related Content

      Learn More
      Life Sciences

      Products

      Explore products for life sciences companies.

      Learn More
      Life Sciences

      Resources

      Discover valuable insights and industry trends.

    • Direct Material Supplier

      Direct Material Supplier

      Direct material suppliers face unique challenges in supply chain coordination. TraceLink provides specialized solutions to address and overcome these issues.
      Learn More
      Left fast
      Direct Material Supplier
      • Orchestrating the supply chain
        • Direct Material Supplier
        • Life Sciences Company
        • Contract Manufacturer
        • Third Party Logistics
        • Wholesale Distributor

      Related Content

      Learn More
      Direct Material Supplier

      Products

      Explore products for direct material suppliers.

      Learn More
      Direct Material Supplier

      Resources

      Dive into a world of expert resources and cutting-edge industry knowledge.

    • Contract Manufacturer

      Contract Manufacturer

      Contract manufacturing organizations grapple with distinct supply chain complexities. TraceLink delivers innovative solutions to tackle and streamline these challenges.
      Learn More
      Left fast
      Contract Manufacturer
      • Orchestrating the supply chain
        • Contract Manufacturers
        • Life Sciences Company
        • Direct Material Supplier
        • Third Party Logistics

      Related Content

      Learn More
      Contract Manufacturer

      Products

      Explore products for contract manufacturers and contract packagers.

      Learn More
      Contract Manufacturer

      Resources

      Get insights and industry trends for contract manufacturers and packagers.

    • Third Party Logistics

      Third Party Logistics

      Third party logistics providers face unique challenges in managing intricate supply chains. TraceLink offers strategic solutions to effectively address these complexities.
      Learn More
      Left fast
      Third Party Logistics
      • Orchestrating the supply chain
        • Third Party Logistics
        • Life Sciences Company
        • Contract Manufacturer
        • Wholesale Distributor

      Related Content

      Learn More
      Third Party Logistics

      Products

      Browse our range of products for third party logistics providers.

      Learn More
      Third Party Logistics

      Resources

      Step into our resource hub for the latest in innovation and industry expertise.

    • Wholesale Distributor

      Wholesale Distributor

      Wholesale distributors navigate complex challenges in supply chain management. TraceLink provides advanced solutions to efficiently tackle these issues.
      Learn More
      Left fast
      Wholesale Distributor
      • Orchestrating the supply chain
        • Wholesale Distributor
        • Life Sciences Company
        • Healthcare Provider
        • Retail Pharmacy

      Related Content

      Learn More
      Wholesale Distributor

      Products

      Browse our range of products for wholesale distributors.

      Learn More
      Wholesale Distributor

      Resources

      Navigate the future of industry trends with our wholesale distributor resource center.

    • Healthcare Provider

      Healthcare Provider

      TraceLink provides specific solutions to help healthcare providers confront distinct challenges, including managing drug shortages and recalls in their supply chains.
      Learn More
      Left fast
      Healthcare Provider
      • Orchestrating the supply chain
        • Healthcare Provider
        • Life Sciences Company
        • Wholesale Distributor

      Related Content

      Learn More
      Healthcare Provider

      Products

      View our product portfolio for healthcare providers.

      Learn More
      Healthcare Provider

      Resources

      Explore our comprehensive collection of resources for healthcare providers.

    • Retail Pharmacy

      Retail Pharmacy

      Retail pharmacies combat supply chain complexities, including regulatory compliance. TraceLink enhances efficiency and adherence.
      Learn More
      Left fast
      Retail Pharmacy
      • Orchestrating the supply chain
        • Retail Pharmacy
        • Life Sciences Company
        • Wholesale Distributor

      Related Content

      Learn More
      Retail Pharmacy

      Products

      Experience our advanced product lineup for retail pharmacies.

      Learn More
      Retail Pharmacy

      Resources

      Delve into our rich library of resources for retail pharmacies.

  • Network
    Left fast
    Network
    The Advantage of Integrate Once
    The TraceLink Network
    Network

    Explore how a single connection to the TraceLink network can transform your operations, streamline your supply chain processes, and bring unparalleled value to your organization.

    Learn More

    Menu Divider

    • Tracelink Icon The Power of the Platform
    • Tracelink Icon OPUS Solution Environment
    • Tracelink Icon Link Actions
    • Tracelink Icon Reports and Dashboards
    • Tracelink Icon Master Data Exchange
    • Tracelink Icon Message Center
  • Products
    Left fast
    Products
    • Partner Orchestration

      Partner Orchestration

      Transform partner collaboration and rapidly connect with all your partners for enhanced control while reducing risks and costs to improve supply chain visibility and customer delivery performance.
      View All Products
      Left fast
      Partner Orchestration
      • Multienterprise Information Network Tower
        • MINT for External Manufacturing
        • MINT for Serialized Shipments and Receipts
        • MINT for Direct Supply
        • MINT for Logistics
        • MINT for Commerce
        • MINT for Transportation

      Related Content

      Learn More
      Blog

      Accelerate Clinical-Phase Commercialization Through Supply Chain Digitalization

      Discover four essential steps to accelerate clinical-phase commercialization through end-to-end supply chain digitalization.

      Watch Now
      Video

      Cold Chain Excellence with AI and Digital Innovation

      Learn how to elevate your cold chain strategy through digitalization, patient-centric innovation, and AI-driven insights. Discover approaches to improve visibility and reduce risk.

    • Product Orchestration

      Product Orchestration Products

      Meet regulatory requirements around the globe and improve operational efficiency with our suite of Product Orchestration solutions, tailored for comprehensive compliance and streamlined supply chain management.
      View All Products
      Left fast
      Product Orchestration
      • Serialization
        • Serial Number Exchange
        • Serial Number Manager
        • Serialized Operations Manager
        • Smart Event Manager
      • Smart Inventory Tracker
      • Targeted Recalls
      • Product Information Manager
        • Targeted Recalls Notification
        • Product Verification
        • Master Data Sharing
      • Country Compliance
        • US Drug Supply Chain Security Act
        • European Union Falsified Medicines Directive
        • Kazakhstan Pharmaceuticals
        • Kyrgyzstan Pharmaceuticals
        • See All Countries
      • Crypto Code
        • Russia Crypto Code

      Related Content

      Learn More
      Deadline Approaching

      DSCSA

      Comply with U.S. DSCSA requirements.

      Watch Now
      Video

      Locate Recalled Product in Minutes

      See how TraceLink helps you pinpoint which locations received recalled product so you can retrieve it in minutes.

    • Process Orchestration

      Process Orchestration Products

      Streamline your supply chain with Process Orchestration, facilitating seamless collaboration on recalls, change requests, document reviews, compliance exception management, and more.
      View All Products
      Left fast
      Process Orchestration
      • Supply Chain Work Management
        • SCWM for Compliance Exceptions
        • SCWM for Incidents
        • SCWM for Change Requests
        • SCWM for Tasks
        • SCWM for Document Reviews

      Related Content

      Learn More
      Resources

      Supply Chain Collaboration

      Browse insights on how to improve end-to-end supply chain collaboration.

      Learn More
      Supply Chain Excellence Award

      2025 BSMA Supply Chain Management Innovation Award

      Gain insights into award-winning supply chain innovation—TraceLink wins the 2025 BSMA Supply Chain Management Innovation Award for its MINT solution.

    • Orchestration Intelligence

      Orchestration Intelligence Products

      Empower your supply chain decisions with Orchestration Intelligence, harnessing AI, machine learning, and the collective power of the TraceLink network for robust data-driven solutions.
      VIEW ALL PRODUCTS
      Left fast
      Orchestration Intelligence
      • Serialized Product Intelligence
      • Reports and Dashboards

      Related Content

      Learn More
      Reports and Dashboards

      Real-Time Insights with OPUS Reports & Dashboards

      TraceLink Releases OPUS Reports & Dashboards, the first end-user solution designed for real-time visibility into supply networks.

      Learn More
      Blog

      Explore the Top 10 Insights from LogiPharma 2025

      Discover how industry leaders at LogiPharma 2025 are transforming collaboration. Gain actionable strategies to drive business value across complex, global networks.

    • Network Platform-Enabling Products

      Network Platform-Enabling Products

      A comprehensive suite of solutions designed to empower users with advanced administration, communication, data management, and customization capabilities, coupled with services to extend the value of the platform.
      View All Products
      Left fast
      Network Platform-Enabling Products
      • OPUS Administer
      • OPUS Solution Environment
      • Link Actions
      • Master Data Exchange
      • Message Center
      • Automated Validation Manager
      • Healthcare Operational Services Team
      • Technical Account Management Services
  • Resources
    Left fast
    Resources
    • Resource Center

      Resource Center

      Explore our Resource Center for a wealth of knowledge, including videos, solution briefs, blogs, eBooks, and more, offering insights on TraceLink solutions, industry trends, and emerging topics.
      View All Resources
      Left fast
      Resource Center
      • By Segment
        • Life Sciences Company Life Sciences Company
        • Direct Material Supplier Direct Material Supplier
        • Contract Manufacturer Contract Manufacturer
        • Third Party Logistics Third Party Logistics
        • Wholesale Distributor Wholesale Distributor
        • Healthcare Provider Healthcare Provider
        • Retail Pharmacy Retail Pharmacy
      • By Type
        • Webinar Webinar
        • Blog Blog
        • Case Study Case Study
        • EBook EBook
        • Infographic Infographic
        • Podcast Podcast
        • Solution Brief Solution Brief
        • Video Video
        • Whitepaper Whitepaper
    • TraceLink University

      TraceLink University

      Enhance your expertise with TraceLink University: dive into a range of online and instructor-led courses, engaging tech talks, and certification programs designed to elevate your knowledge.
      Explore All
      Left fast
      TraceLink University
      • By Persona
        • Solution Designer Solution Designer
        • Tracelink Administrator Tracelink Administrator
        • User User
        • Orchestration Architect Orchestration Architect
        • Solution Partner Solution Partner
        • Technology Partner Technology Partner
      • By Orchestration
        • Manufacturing Manufacturing
        • Logistics Logistics
        • Commerce Commerce
        • Transportation Transportation
        • Clinical Supply Clinical Supply

      Related Content

      Learn More
      Subscriptions

      TraceLink University

      Ongoing education at your own pace.

      Watch Now
      FutureLink

      Experience FutureLink

      Watch FutureLink Barcelona sessions on demand.

    • Partners

      Partners

      We partner with leaders from across the globe, with an intense focus on partner companies that specialize in implementation, solution consulting, and application development.
      Partner Overview
      Left fast
      Partners
      • Tracelink Icon View Our Partners
      • Tracelink Icon Become a Partner
      • Tracelink Icon Access PartnerLink
    • Community

      Community

      Join our global community, uniting members across the supply chain to share insights and engage in discussions through virtual meetings and collaborative workshops.
      Learn More
      Left fast
      Community
      • Global Compliance Special Interest Group
      • Multienterprise Information Network Tower Innovation Forum
      • U.S. DSCSA Innovation Forum for Manufacturers and Distributors
      • U.S. DSCSA Dispenser Innovation Forum
    • Events

      Events

      Stay updated with our Events calendar: from industry conferences we attend to exclusive events we host and informative webinars, join us in shaping the future of supply chain management.
      View All Events
      Left fast
      Events
      • Tracelink Icon Industry Events
      • Tracelink Icon Webinars
      • Tracelink Icon TraceLink Events

      Related Content

      Register Now
      FutureLink

      FutureLink Barcelona 2025

      Join the movement shaping the future of supply chains. FutureLink is the must-attend event for Industry leaders.

      Register Now
      Paris Seminar

      Intelligent Orchestration of Your End-to-End Supply Chain

      Explore how intelligent orchestration enhances resilience, agility, and performance on June 11 in Paris.

    • Customers

      Customers

      Meet a selection of our valued customers: discover how diverse businesses are leveraging TraceLink's solutions to transform their supply chains.
      View Our Customers
      Left fast
      Customers
      • Success Stories
        • Santen Santen
        • Merck Merck
        • Patheon Patheon
        • Sentara Sentara
        • Merz Therapeutics Merz Therapeutics
  • About
    Left fast
    About
    • Tracelink Icon Our Story
    • Tracelink Icon Newsroom
    • Tracelink Icon Culture and Careers
    • Tracelink Icon Leadership
    • Tracelink Icon Our Values
    • Tracelink Icon Corporate Social Responsibility

    Menu Divider

    Related Content

    Awards and Recognitions

    Celebrating our impact

    We are honored and proud of the acknowledgment and industry recognition we have received.

    Innovation Award

    Supply Chain Orchestration Company of the Year 2025

    Discover how TraceLink is transforming supply chain orchestration—named Supply Chain Orchestration Company of the Year 2025 by Logistics Tech Outlook Magazine.

  • CONTACT US
  • User Log In
    • Tracelink Classic
      TraceLink Classic app.tracelink.com
      Redirect
    • Opus Platform
      Opus Platform opus.tracelink.com
      Redirect
Close
CONTACT US
Tracelink University

Breadcrumb

  1. Home
  2. Resources
  3. TraceLink University

UX Writing and Terminology

Enhancing User Experience Through Strategic Content Design
banner-image
  • Download PDF
  • Share
    • LinkedIn
    • Facebook
    • Mail
    • Twitter

Table of contents

Overview and Patterns

We strive for UI text that is as clear and concise as possible, while giving users the right amount of information to help them get their jobs done. 

Best Practices

  • Be concise.
  • Write in the present tense.

Example of writing in present tense.

  • Use numerals (e.g. 1, 2, 3) instead of spelling out numbers.
  • Write with direct, simple language that is easy to understand. Make sure your writing communicates only the essential details and is written for all reading levels.
  • Our styles, patterns, and vocabulary are based on US English, which is the default language for OPUS Ensemble (e.g. Acknowledgment, not Acknowledgement). However, take localization into careful consideration for all of your writing decisions.

Writing Style

Our writing style is friendly and direct while remaining professional. The majority of our users work in supply chain industries, so we want to make sure the content is as direct and clear as possible to help our users get their jobs done efficiently and effectively, which results in user trust in the software and documentation we provide.

Point of View

  • Use second person (i.e. you and your) where it makes sense to do so. However, always ask yourself if using second person provides more value than the more neutral and professional third person. Do not use second person when the action users are taking is on behalf of their entire company, because second person could be confusing in this situation, especially once localized.

Example of when to write in second person.

  • Avoid using first person (i.e. me, my) except for screen titles related to the user's profile.
  • Never combine first and second person in the same sentence or phrase.

Capitalization

  • Use title case for all titles and labels within the experience.

Example of when to use title case.

  • Use sentence case for all assistive text.

Example of when to use sentence case.

Other Sources

For any guidelines not covered in this guide, we refer to the Microsoft Writing Style Guide. 

UI Text Patterns

UI text refers to any text that displays on the screen. This includes but is not limited to titles, labels, assistive text that explains concepts on the screen, buttons, confirmation messages, snackbars, and alt text for images. 

Side Menu Labels

The side menu displays submenus and menu items that are grouped within submenus.

Submenu Labels

  • There are no restrictions on what you can name submenus, but be sure to target the business segment (e.g. MAH, CMO, 3PL) and the use case context where similar objects will be grouped to fulfill those use cases.

Example of submenu label.

Menu Item Labels

  • Menu items (including subtypes) must be tied to a primary object and must be labeled accordingly.
  • When labeling menu items for primary objects, be sensitive to who the persona is and what role they play in the relationship and context of that app. Capture the appropriate directionality. For example, a user from an Owner may perceive a transaction as being “sent”, while a Partner may perceive that same transaction as being “received”.

Example of menu item label.

Screen, Section, Push Panel, Dialog, and Component Titles

Standard Screen Titles

The screen type determines the pattern used for the screen title.

  • For Search screens, the title of the screen must be “Search [Menu Item]”, where [Menu Item] is the side menu item associated with the Search screen. For example, if users select the Purchase Orders menu item, the screen they land on must be titled Search Purchase Orders.

Example of Search screen title.

  • For View/Edit screens, use the following pattern: “[Object Type Name] Details.” For example, if users select a purchase order while on the Search Purchase Orders screen, the screen they land on must be titled Purchase Order Details. If they choose to edit that purchase order, the screen changes from view mode to edit mode and the screen title remains Purchase Order Details.

Example of View/Edit screen title.

  • For New screens, use the pattern: “New [Object Type Name].” For example, if users select the New button while on a Search Purchase Orders screen, the screen they land on must be titled New Purchase Order.
  • Use action-oriented titles for all screens.
  • Avoid punctuation in screen titles.

Push Panel Screen Titles

  • When users are exporting data from the system, use "Export [Object Types]" (e.g. Export Incidents) as the push panel title.
  • When users are adding a new item to a collection, use "New [Field Name]" (e.g. New Line Item).
  • When users are performing other actions (e.g. editing or removing a collection item), use "[Action] [Field Name]” (e.g. Edit Line Item or Remove Line Item). For guidance on the wording of actions, see the Vocabulary section.
  • For view-only (or view as the primary purpose) push panels, use “View Details” as the title with no other words. Do not include the object name.

Example of view-only push panel.

  • Avoid punctuation in push panel titles.

Dialog Screen Titles

  • The only use case for a dialog is when changing from edit mode to view mode without saving changes, to alert users that their changes will be lost. Use “Unsaved Changes”.
  • Avoid punctuation in dialog titles, even for confirmation actions.

Example of dialog screen title.

Other Component Titles

  • Spell out "Identifier" in collection names. Use “ID” for field names. This provides for more horizontal space without losing clarity.
  • For steps within a Progress Indicator:
    • The title of each step in the Progress Indicator should follow the pattern "Step [Numeral]: [Workflow State of Object Type]" (e.g. Step 1: Pending, Step 2: Prepare Inbound, Step 3: Process Inbound, Step 4: Prepare Outbound, Step 5: Process Outbound).
    • The section headers within each step should match the workflow state from the step title (e.g. Submit, Processing, Processed, Preparing To Send, Sending). 

Button Labels

  • Use active verbs as the labels for all buttons. The exception is “New,” which is used instead of “Create.” See the Vocabulary section for specific verbs and how we use them.
  • Use verbs that indicate what the user actually wants to accomplish (e.g. New, View), instead of generic button labels (e.g. Submit).
  • Keep button labels to one word. If buttons need more clarification, you can use additional words in the alt text. However, always use the title of the screen, dialog, or push panel to clarify first.

Action Icons and Menu Labels

  • Use active verbs as the labels. See the Vocabulary section for specific verbs and how we use them.
  • Use verbs that indicate what the user actually wants to accomplish (e.g. View, Edit), instead of generic labels (e.g. Manage).

Example of using verbs that indicate what user wants to accomplish in action icons and menu labels.

  • Any nouns included in the label must be singular, not plural, even if users can take action on multiple objects at once. The exception to this is Search page headers (e.g. Search Purchase Orders).

Example of using singular nouns in action icons and menu labels.

Field Labels

  • The shortest label is ideal. Avoid labels that use multiple nouns, unless they all provide explicit value. For example, in Supplier Name, Name is an extraneous noun because Supplier gives users all of the relevant information.
  • Do not include punctuation, even on toggles with Yes and No values.

Example of field label.


Dates

  • For fields that represent dates in the past, use "Date [Action]ed" instead of  "[Action] Date." The exceptions to this rule are "Expiration Date" and "Event Date" because these are supply chain industry terms.

Example of how to write date in the past.

  • For fields that represent due dates in the future, use "[Noun] Due Date" instead of "Date [Noun] Due."

Example of how to write date in the future.

  • Date and time values should always display in the following formats:
    • Date –  DD Mmm YYYY
    • Date and Time – DD Mmm YYYY HH:MM AM/PM
    • Date, Time, and User – DD Mmm YYYY HH:MM AM/PM by [User Name]

Workflow States

  • For workflows with 3 states, the default workflow state names could be "To Do," "In Progress," and "Done."
  • For workflows with more than 3 states or workflows that require more specific names, name all but the final state using active verbs or adjectives that describe what is happening while the object is in that state. For the final state name, use a verb in the past tense.

Image showing workflow states.

  • Avoid deviating from the default state names if the new name does not bring additional meaning to the state. For example, Not Started is extremely similar to To Do, and does not provide additional clarity or specificity. However, In Review is clearly more specific and provides additional meaning than In Progress.

Confirmation Messages

  • For operations users can do in a push panel that require a confirmation before proceeding (e.g. removing an object), use:
    • Push Panel title: Remove [Object]
    • Message 1st line: “The [object] will be removed and cannot be retrieved.”
    • Message 2nd line: “Remove this [object]?”
    • Buttons: Cancel | Remove

Snackbars

  • For system errors that users cannot do anything about, use this generic message: "Something went wrong. Try again later. If the issue continues, contact [App Provider name, and the name of their support department if available]."
  • For messages that contain a list of values:
    • Write the message as a stem sentence that introduces the list of values.
    • Use a colon at the end of the stem sentence.
    • Do not include a period at the end of the list or a conjunction (i.e. and, or) prior to the last value. 

Success Messages

  • For synchronous actions, use this pattern: "The [specific name] [object type] is [action in past tense].”

Example of success message for synchronous action.

  • For asynchronous actions (e.g. exporting data that takes time before it is available), use this pattern: "[App Provider Name] is [action]. [Description of how users know when the action is complete or where to find the result]."
    • For asynchronous export actions, use this pattern: "[App Provider Name] is exporting the [File Name] file. The file will be available in your notifications when it is ready."
  • The OPUS Platform backend initially writes new and updated data to a different database than the platform reads data from, which allows for high availability during app deployments. This functionality means that when users update the UI, they might not see their updates immediately, but they will see their updates momentarily (in under one minute). Because the updates display in under one minute, these actions are not truly asynchronous. Add these sentences to your confirmation messages when users land on a screen where they expect to see the updates they just made:
    • For adding an object when redirected to the Search screen: "[success message]. The new [object type] will display shortly."
    • For editing an object while on the [Object Instance] Details screen: "[success message]. The updates for this [object type] will display shortly."
    • For removing an object while on the Search screen or while on the [Object Instance] Details screen and then redirecting to the Search screen: "[success message]. The [object type] will stop displaying shortly."
    • For changing an object status while on the Search screen or while on the [Object Instance] Details screen and then redirecting to the Search screen: "[success message]. The new [object type] status will display shortly."
    • For adding a related object while on the [Object Instance] Details screen of an existing object: "[success message]. The new [object type] will display shortly."
    • For editing a related object while on the [Object Instance] Details screen of an existing object: "[success message]. The updates for this [object type] will display shortly."
    • For removing a related object while on the [Object Instance] Details screen of an existing object: "[success message]. The [object type] will stop displaying shortly."
  • System-generated IDs should not be used in success messages for Add actions. These success messages should only include values from the form the user has just filled out.
  • If users are not currently on or are redirected to the screen where the new or updated information should display and must navigate to a different screen to see that information, the extra sentence in the success message is not needed because the information will display by the time users search for and find it. For example, you might have a form that refreshes with blank fields when users select Apply, and then users must navigate back to the Search screen and enter filter criteria before any results display. By the time they find the object they are looking for, the information will be updated and reflect accurately on the screen.

Error Messages

  • For required fields that are left blank, use the following generic message: “One or more required fields is not filled in." 
    Ideally, required fields that are left blank should be indicated with a field-level error instead of a snackbar error message. Use this field-level error if field-level errors are available or for errors in API responses: "[Field Label] is required."
  • State the error that occurred in the first sentence, and then in a second sentence, state why the error occurred. If possible, phrase the second sentence as an instruction that explains what users must do to correct the error.

Example error message.

  • If you refer to a specific value, capitalize the field label as a proper noun and place the field label (e.g. Purchase Order) in front of the value (e.g. [PO Number]).

Example error message containing a specific value.

Notifications

Notifications are available in the Notifications push panel and by email. 

Notifications Push Panel

Each notification displays the following information:

  • Title ("Notifications")
  • Sender (e.g. Solution name)
  • Subject (e.g. Business Object name)
  • Message
  • Link to the subject in the form "View Details" which opens the respective solution or network frame in a new OPUS tab
  • Timestamp when created:
    • If less than 24 hours ago - “[N] hours ago”
    • If more than 24 hours but less than 2 days - “1 day ago”
    • If more than 2 days but less than 7 days - “N days ago”
    • If between 14 days and 21 days - “2 weeks ago”
    • If between 21 days and 30 days - “3 weeks ago”
    • If between 30 days and 59 days - “1 month ago”
    • If more than 59 days - “[N] months ago”
      • N = ([Number of Days since created]/30) rounded down to nearest integer

Email Notification

For the email notification:

  • Subject – Your [Solution Provider Name] [File Type] File is Ready
    • Subject lines should always be in title case, without end punctuation.
  • Body – 
    The [App Name] [file type] file you requested on [Timestamp: DD Mmm YYYY HH:MM] is now available:
    [Link to the file in the form of the file name]

Assistive Text

Assistive text is UI text that provides users with guidance, rather than labeling a UI element. Include assistive text for screens, sections, push panels, dialogs, and components when it is useful. Do not include assistive text if it does not provide real value (i.e. the screen, section, push panel, dialog, or component is self-explanatory even to new users).

Screen-Level

  • Use punctuation at the end of the sentence, even if the assistive text only consists of one sentence.
  • When users are confirming an action in a push panel (e.g. removing an object from the system), use this pattern: "[Implications of action, including the specific object being acted on]. [Action] this [object]?"

Example of screen-level assistive text.

  • When users are importing data:
    • Use this pattern: "Select a file containing [contents of file] to [action being taken with the imported data]. Match the CSV's format to the following sample: [Object]Sample.csv"
      • For example: "Select a file containing review information to add or modify. Match the CSV's format to the following sample: PurchaseOrderSample.csv"
    • The sample CSV file name should have a link that downloads an example file when selected.
    • Don't include a period at the end of the second sentence. 

Empty States

  • For searches with zero results, use this generic message: "No results found. Try modifying the search criteria."
  • For components that do not have any data, and where users cannot modify search results, use this generic message: "No data available."
  • For components that do not have any data because nothing has been added yet (i.e. first-time messages), use this pattern: "No [objects] are currently [verb or description]."

Example of an empty state message.

Vocabulary

We chose these words so that our UI text is consistent across all experiences. Make sure you also use consistent word choices across your experience for anything not covered here.

WordNotes
app and application
  • Use "application" for all field labels.
  • Use "app" in assistive text (i.e. UI text in sentence case), unless "application" truly fits better in the context.

Note: Refer to the solutions names, solution short names, and network names since apps are not user-facing. However, app locations may be used for app development context.

apply

Instead of: submit, save, edit, update

For actions in the push panel when manipulating information so you can preview the information in the content area, but it is not saved.

attach

Instead of: upload, import

When the user is inputting a file as-is that does not require transformation (e.g. the process of attaching an image or document to a business object).

”Attach” is used as a noun or as a verb. For example, choose an attachment (noun), or attach a file (verb).

clone

Instead of: copy

Creates a new object instance based on an existing object.

customer

Instead of: buyer

For referring to other entities that purchase a product or service from TraceLink. Use Owner when indicating TraceLink customers. 

download (download attachment)

Instead of: export

Anthem components are set up to avoid using the word “download”. Instead, they present a link to the user with the file name. This reduces the cognitive load for less technical users, so they do not have to discern the difference between "export" and "download." However, if necessary, use "download" when the user is getting data out of TraceLink that does not require transformation (e.g. the process of downloading any file that is attached to a business object).

For example, in OPUS Solution Environment (OSE), use "download" when taking a Company Solution and making it available, when the intention is to use the solution as is (e.g. without additional configuration).

edit

Instead of: update, modify

"Edit" is a standard object operation and is used as the verb only.

emailInstead of: email address 
enter

Instead of: select, specify

For assistive text when users must type the values into text fields, type-ahead fields, or available values fields. 

expand and collapse

Instead of: show and hide

Use "Expand All" and "Collapse All" for expanding and collapsing all sections on a form or all components within a screen. Use "Show" and "Hide" to show and hide single components.

expiration dateInstead of: expiry
export

Instead of: download

When the user is extracting data from any number of sources that requires transformation and produces a file as output (e.g. exporting a table as a CSV file).

identifierWhen used as a field label, abbreviate as "ID" (e.g. Reviewer ID). 
import

Instead of: upload, attach

When the user is uploading a file and importing data into an app in some business context that is determined by that app. This is done in the push panel when manipulating information so you can preview the information in the content area, but it is not saved.

item code

Instead of: packaging code, product code, identifier

Identifies the actual pharmaceutical product. This could be a country drug code (e.g. NDC, DE-PZN) or an Internal Material Number maintained by the company.

last

Instead of: past, previous

For example, “Last 30 Days” might be a value in a chart. 

line itemInstead of: order item, PO item, purchase order item, item
locationInstead of: site
lot numberInstead of: lot, batch
modified

Instead of: updated, edited

"Modified" is used as the adjective only.

Note: This is applicable to Audit Trail / 21 CFR Part 11 standards.

nameFor "Name" fields within forms (i.e. on New or View/Edit screens), only include an adjective in the field label (e.g. Company Name) if users might not understand what is being named (e.g. if there is another Name field on the same form). 
new

Instead of: add, create

  • For titles, use "New [Page]" or "New [Object]".
  • For object operations, "New" creates a new object. If you are editing an existing object and select "New," your changes are not saved.
packaging code

Instead of: item code, product code

Identifies the specific packaging level of that pharmaceutical product and is included within the serial number (e.g. GTIN, NTIN, CN-Rescode).

packaging levelInstead of: packaging unit of measure, packaging UOM
product code

Instead of: item code, packaging code

Refers to either the item code or the packaging code (i.e. any code that refers to the product or its packaging). For field labels, ideally, you should use "Item Code or Packaging Code" to be specific and avoid confusion. However, if space is limited, you can use "Product Code". 

regionInstead of: province
removeInstead of: delete
save

Instead of: edit, update, submit

Always use "Save" as the button label for View/Edit and New screens. "Save" updates the backend.

save and newAlways use “Save and New” as the button label for a New screen when you want to create a new instance and remain on the New screen.
select

Instead of: enter, specify, click

For assistive text when users must select a value from a date picker, drop-down, or radio button. "Select" is device-agnostic. 

shipment and receipt

Instead of: delivery, transaction

Delivery is only used for referring to shipments and receipts collectively, if absolutely necessary. Otherwise always use the specific term for outbound shipments and inbound receipts. 

show and hide

Instead of: expand and collapse

Use "Show" and "Hide" for showing and hiding single components. Use "Expand All" and "Collapse All" for expanding and collapsing all sections on a form or all components within a screen. 

specify

Instead of: enter, select

For assistive text when users must both enter and select values on the same screen or section. 

state

Instead of: status

Use “state” when referring to workflows.

status

Instead of: state

Use “status” when referring to processing statuses.

supplierInstead of: seller, vendor
viewFor viewing an existing object and its details. If you are editing an existing object and select "View," your changes are not saved and you are navigated back to the View/Edit screen.

 

 

TraceLink University

Table of contents

Related Content
Opus Ensemble UX
Introducing OPUS Ensemble
TraceLink's OPUS Ensemble, the first next-generation solution on the OPUS Platform, revolutionizes user interaction by seamlessly integrating personalized settings, powerful navigation, and company-specific context for efficient access to notifications, support, and essential tools.
View More
Opus Ensemble
OPUS Ensemble Patterns
Enabling OPUS Solution Designers to understand Ensemble patterns, which includes user context, settings, and browser-style navigation for streamlined access.
View More
Anthem Design Guide
Get Started Designing on the OPUS Platform With OPUS Anthem
Anthem is TraceLink's Design System that establishes consistent design conventions across the OPUS Platform, allowing designers to quickly create solutions that meet various business and user needs.
View More
solution designer
OPUS Solution Environment
A no-code, drag-and-drop environment that enables business users to tailor the workflows and user experiences of TraceLink solutions to the unique requirements of their supply chain without the need for specialized technical skills or extensive coding knowledge.
View More
Opus Solution Designer
Transforming Supply Chain Orchestrations With OPUS Solution Environment (OSE)
The OPUS Solution Environment (OSE) empowers organizations to rapidly adapt and innovate by allowing OPUS Solution Designers, regardless of coding skills, to create robust solutions without code, while also supporting advanced configurations with JavaScript for greater flexibility.
View More
Page Types
Understanding Page Types within the OPUS Solution Environment (OSE)
Page types enable Solution Designers to efficiently create user-friendly pages using a drag-and-drop interface, allowing them to organize information for optimal usability.
View More

Cookie Settings

When you visit any website, it may store or retrieve information on your browser, mostly in the form of cookies or similar tracking technologies. Please see below for an overview of the categories of cookies and similar technologies used on this site. You can allow or deny some of all of them, except Strictly Necessary Cookies which are required to provide the site to you. However, blocking some types of cookies may impact your experience of the site and services we are able to offer.

Please see our Cookie Policy for more details, including a list of the cookies we use. You can change your consent options at any time by following the “Cookie Settings” link in the Cookie Policy.
'Strictly Necessary' cookies let you move around the Site and use essential features like secure areas, shopping baskets and online billing. Without these cookies you would not be able to navigate between pages or use certain vital features of our Site, so we do not require your consent for their use. These cookies don't gather any information about you that could be used for marketing or remembering where you've been on the internet. For example, we use these Strictly Necessary cookies to identify you as being logged in to the Site. You can set your browser to block or alert you about these cookies, but if you do so, some parts of the Site will not work.
'Performance' cookies collect information about how you use the Site, such as which pages you visit, the time spent on the Site and if you experience any errors. We use performance cookies to provide aggregated statistics on how the Site is used and help us improve the Site including by measuring any errors that occur.
'Functional' cookies are used to provide services or to remember settings to improve your visit. We use 'Functionality' cookies to remember your settings and choices and show you when you're logged in to the Site.
‘Targeting' cookies are linked to services provided by third parties, such as 'Like' buttons and 'Share' buttons. The third party provides these services in return for recognizing that you have visited the Site. We also use 'Targeting' cookies to gather information that could be used to display content that we think may interest you.
Home

Footer

  • Quick Links
    Get a Demo
    Fast Facts
    The Network
    OPUS Platform
    Technical Support
    Open Jobs
    API: Terms of Use
  • Products
    Multienterprise Information Network Tower
    U.S. DSCSA Compliance
    Targeted Recalls
    Supply Chain Work Management
    Serialization
    Global Compliance
  • Resources
    Resource Center
    Events
    TraceLink University
    Partners
    Customers
    Community
  • About TraceLink
    Our Story
    Newsroom
    Culture & Careers
    Leadership
    Our Values
    Corporate Social Responsibility
  • Hot Topics
    Supply Chain Visibility
    DSCSA Compliance
    Supply Chain Collaboration
    Kazakhstan Compliance for Pharmaceuticals
    Kyrgyzstan Compliance for Pharmaceuticals
Follow Us on Social
Facebook
Linkedin
X
Legal & Trust.
© TraceLink Inc. 2009-2025 All Rights Reserved
Contact Us Today
Contact us today to digitalize your end-to-end supply chain for streamlined orchestration.
Contact Us
Stay Up-to-Date
Subscribe to receive industry insights and stay at the forefront of evolving trends.
Subscribe