← Files TemporalARCHIVED FILE
skills/temporal-developer/references/java/priority-fairness.md
1.72 KB · Nov 19, 2026 · 00:18 UTC
# Task Queue Priority and Fairness in Java
Read [Temporal Task Queue priority and fairness guide](../core/priority-fairness.md) first for the cross-SDK behavior, configuration, and limitations.
Java represents Priority and Fairness metadata with `io.temporal.common.Priority`. Unset fields inherit independently. Set only the Priority key for Priority-only use, or only the Fairness fields to use the default Priority.
```java
Priority tenantPriority = Priority.newBuilder()
.setPriorityKey(1)
.setFairnessKey("tenant-123")
.setFairnessWeight(2.0f)
.build();
```
## Start a Workflow
Set `Priority` in `WorkflowOptions`:
```java
WorkflowOptions options = WorkflowOptions.newBuilder()
.setWorkflowId("my-workflow-id")
.setTaskQueue("my-task-queue")
.setPriority(tenantPriority)
.build();
MyWorkflow workflow = workflowClient.newWorkflowStub(MyWorkflow.class, options);
workflow.run("input");
```
## Override an Activity
Set `Priority` in `ActivityOptions`:
```java
ActivityOptions options = ActivityOptions.newBuilder()
.setStartToCloseTimeout(Duration.ofSeconds(30))
.setPriority(tenantPriority)
.build();
MyActivities activities = Workflow.newActivityStub(MyActivities.class, options);
String result = activities.processOrder("order-123");
```
## Override a Child Workflow
Set `Priority` in `ChildWorkflowOptions`:
```java
ChildWorkflowOptions options = ChildWorkflowOptions.newBuilder()
.setWorkflowId("my-child-workflow-id")
.setPriority(tenantPriority)
.build();
MyChildWorkflow child =
Workflow.newChildWorkflowStub(MyChildWorkflow.class, options);
String result = child.run("input");
```
If an Activity or Child Workflow omits `Priority`, it inherits the parent Workflow's values.
SHA-256: 0d3cb21923be327961d318cda8c5eff1515d0d21232de50f8c114f31b751845f