Best practices

Jobs

Naming jobs

Use an action verb at the beginning of your job title so that it reads like an action users can trigger. Job titles are displayed as actions in the UI, for example in the jobs app:

Good examples:

• Generate product catalog
• Import ERP prices
• Export items to marketplace

Table schema

Naming keys

If you are creating a new structure from scratch within Product-Live

Always use uppercase letters. If there are several words, use an underscore to separate them. Use English and keep keys as short and meaningful as possible. Examples:

Title	Key
Products	PRODUCTS
Order details	ORDER_DETAILS

If you are connecting an existing system

Reuse the keys or IDs from the connected system. In this case, keys can be text or numbers.

Naming with plural or singular

The choice between plural and singular depends on the type of entity. Recommended conventions:

Type	Best practice
Table	Plural
Level	Singular
Partition	Plural
Identifier	Singular
Classification	Singular
Category	Singular