Fluent Commerce Logo
Docs

Label Naming Conventions

Essential knowledge

Author:

Fluent Commerce

Changed on:

25 Oct 2023

Overview

This page provides naming recommendations to follow for labels across the Fluent platform.
  • nameSpace.domain.[subdomain].module.[submodules...].label
  • submodules = page.tab.component(card/table)
  • All levels use the singular. For example, order instead of orders and component instead of components.
  • Use Camel Case to separate words. For example,: fc.om.order.ui.list.title).

Key points

  • Namespace
  • Domain
  • Module
  • Label

Namespace

fc namespace is reserved for Fluent Commerce components and keys. Partners have their own namespace.Example: fc.om.order.ui.list.title


Domain

The domain represents the Fluent domain where the key is used. For example, Order Management (om), Global Inventory (gi), and Product Availability (pa).Example: fc.om.order.ui.list.title
Subdomain
Subdomain represents the entity within the primary domain where this key is used. For example, the keys used in the order entity will have order as the subdomain.Example.: fc.om.order.ui.list.title


Module

The module is the section where key is used within the application. All UI labels have ui as the module key.Example: fc.om.order.ui.list.title
Sub modules
There can be a number of sub-modules. For example, the page (list or details), card (summary), tab or list can be included as sub module to create a unique key.Example: fc.om.order.ui.list.title


Label

Label represents the value that is getting translated.Example: fc.om.order.ui.list.titleThe entire key is checked to find a matching translation available in the language resource bundles.For example:

Order Management Domain

non-UI-centric order 
fc.om.order.[....].status.created fc.om.order.status.booked fc.om.order.type.hd fc.om.order.type.cc
order listing page
fc.om.order.ui.list.nav fc.om.order.ui.list.title fc.om.order.ui.list.results.column.ref fc.om.order.ui.list.results.column.customer fc.om.order.ui.list.results.column.status fc.om.order.ui.list.results.column.retailer
customer listing page
fc.om.customer.ui.list.nav fc.om.customer.ui.list.title fc.om.customer.ui.list.results.column.ref fc.om.order.ui.detail.title # page title fc.om.order.ui.detail.overview.title # tab title
overview (tab), summary (card) 
fc.om.order.ui.detail.overview.summary.title fc.om.order.ui.detail.overview.summary.field.type fc.om.order.ui.detail.overview.summary.field.status fc.om.order.ui.detail.overview.summary.field.created
overview (tab), retailer (card)
fc.om.order.ui.detail.overview.retailer.title fc.om.order.ui.detail.overview.retailer.field.retailer
fulfilment (tab), list (card/table)
fc.om.order.ui.detail.fulfilment.title fc.om.order.ui.detail.fulfilment.list.title fc.om.order.ui.detail.fulfilment.list.column.id fc.om.order.ui.detail.fulfilment.list.column.status fc.om.order.ui.detail.fulfilment.list.column.deliveryType fc.om.order.ui.detail.fulfilment.list.column.workflow fc.om.order.ui.detail.tab.overview fc.om.order.ui.detail.tab.fulfilment fc.om.order.ui.detail.summary.field.type fc.om.order.ui.detail.summary.field.status fc.om.order.ui.detail.summary.field.created
Fluent Commerce

Fluent Commerce