Quinn-With-Two-Ns · Oct 14, 2026 · Oct 12, 2026
@@ -27,6 +27,8 @@ to docs, or any other relevant information.
   Child workflow overrides and one-time routing require Temporal Server 1.32.0 or later.
 - `WorkerFactoryOptions.Builder.setLoggerTagPrefix` that can be used to customized structured logging tags (MDC keys)
   set by Temporal SDK in worker context.
+- Spring Boot: the `workers` attribute of `@WorkflowImpl`, `@ActivityImpl` and `@NexusServiceImpl` now resolves property
+  placeholders such as `${my.worker.name}`, as `taskQueues` already does.
 
 ### Changed
 - Release notes for all future releases are now in a single CHANGELOG.md file. `releases` directory with old release

@@ -15,7 +15,7 @@
   /**
    * @return names of Workers to register this activity bean with. Workers with these names must be
    *     present in the application config. Worker is named by its task queue if its name is not
-   *     specified.
+   *     specified. Can be specified as a property key, e.g.: ${propertyKey}.
    */
   String[] workers() default {};
 

@@ -15,7 +15,7 @@
   /**
    * @return names of Workers to register this nexus service bean with. Workers with these names
    *     must be present in the application config. Worker is named by its task queue if its name is
-   *     not specified.
+   *     not specified. Can be specified as a property key, e.g.: ${propertyKey}.
    */
   String[] workers() default {};
 

@@ -15,7 +15,8 @@
   /**
    * @return names of Workers to register this workflow implementation with. Workers with these
    *     names must be present in the application config or auto-discovered from {@link
-   *     #taskQueues()}. Worker is named by its task queue if its name is not specified.
+   *     #taskQueues()}. Worker is named by its task queue if its name is not specified. Can be
+   *     specified by a property key, e.g.: ${propertyKey}.
    */
   String[] workers() default {};
 

@@ -306,6 +306,7 @@ private void configureWorkflowImplementationsByWorkerName(
       WorkflowImpl annotation = AnnotationUtils.findAnnotation(clazz, WorkflowImpl.class);
 
       for (String workerName : annotation.workers()) {
+        workerName = environment.resolvePlaceholders(workerName);
         Worker worker = workers.getByName(workerName);
         if (worker == null) {
           throw new BeanDefinitionValidationException(
@@ -328,6 +329,7 @@ private void configureActivityBeansByWorkerName(
           ActivityImpl annotation = AnnotationUtils.findAnnotation(targetClass, ActivityImpl.class);
           if (annotation != null) {
             for (String workerName : annotation.workers()) {
+              workerName = environment.resolvePlaceholders(workerName);
               Worker worker = workers.getByName(workerName);
               if (worker == null) {
                 throw new BeanDefinitionValidationException(
@@ -353,6 +355,7 @@ private void configureNexusServiceBeansByWorkerName(
               AnnotationUtils.findAnnotation(targetClass, NexusServiceImpl.class);
           if (annotation != null) {
             for (String workerName : annotation.workers()) {
+              workerName = environment.resolvePlaceholders(workerName);
               Worker worker = workers.getByName(workerName);
               if (worker == null) {
                 throw new BeanDefinitionValidationException(

@@ -0,0 +1,65 @@
+package io.temporal.spring.boot.autoconfigure;
+
+import io.temporal.api.nexus.v1.Endpoint;
+import io.temporal.client.WorkflowClient;
+import io.temporal.client.WorkflowOptions;
+import io.temporal.client.WorkflowStub;
+import io.temporal.spring.boot.autoconfigure.bytaskqueue.TestWorkflow;
+import io.temporal.testing.TestWorkflowEnvironment;
+import org.junit.jupiter.api.*;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.ConfigurableApplicationContext;
+import org.springframework.context.annotation.ComponentScan;
+import org.springframework.context.annotation.FilterType;
+import org.springframework.test.context.ActiveProfiles;
+
+@SpringBootTest(classes = AutoDiscoveryByWorkerNameResolverTest.Configuration.class)
+@ActiveProfiles(profiles = "auto-discovery-by-worker-name-dynamic-name")
+@TestInstance(TestInstance.Lifecycle.PER_CLASS)
+public class AutoDiscoveryByWorkerNameResolverTest {
+  @Autowired ConfigurableApplicationContext applicationContext;
+
+  @Autowired TestWorkflowEnvironment testWorkflowEnvironment;
+
+  @Autowired WorkflowClient workflowClient;
+
+  Endpoint endpoint;
+
+  @BeforeEach
+  void setUp() {
+    applicationContext.start();
+    endpoint =
+        testWorkflowEnvironment.createNexusEndpoint(
+            "AutoDiscoveryByWorkerNameTestEndpoint", "PropertyResolverTest");
+  }
+
+  @AfterEach
+  void tearDown() {
+    testWorkflowEnvironment.deleteNexusEndpoint(endpoint);
+  }
+
+  @Test
+  @Timeout(value = 10)
+  public void testAutoDiscovery() {
+    TestWorkflow testWorkflow =
+        workflowClient.newWorkflowStub(
+            TestWorkflow.class,
+            WorkflowOptions.newBuilder().setTaskQueue("PropertyResolverTest").build());
+    testWorkflow.execute("nexus");
+
+    WorkflowStub dynamicStub =
+        workflowClient.newUntypedWorkflowStub(
+            "DynamicWorkflow",
+            WorkflowOptions.newBuilder().setTaskQueue("PropertyResolverTest").build());
+    dynamicStub.start();
+    Assertions.assertEquals("hello from dynamic workflow", dynamicStub.getResult(String.class));
+  }
+
+  @ComponentScan(
+      excludeFilters =
+          @ComponentScan.Filter(
+              pattern = "io\\.temporal\\.spring\\.boot\\.autoconfigure\\.bytaskqueue\\..*",
+              type = FilterType.REGEX))
+  public static class Configuration {}
+}
@@ -5,7 +5,7 @@
 import org.springframework.stereotype.Component;
 
 @Component("TestActivityImpl")
-@ActivityImpl(workers = "mainWorker")
+@ActivityImpl(workers = "${default-worker.name:mainWorker}")
 @Profile("auto-discovery-with-profile")
 public class OtherTestActivityImpl implements TestActivity {
   @Override

@@ -7,7 +7,7 @@
 import org.springframework.context.ConfigurableApplicationContext;
 import org.springframework.context.annotation.Profile;
 
-@WorkflowImpl(workers = "mainWorker")
+@WorkflowImpl(workers = "${default-worker.name:mainWorker}")
 @Profile("auto-discovery-with-profile")
 public class OtherTestWorkflowImpl implements TestWorkflow {
 

@@ -5,7 +5,7 @@
 import org.springframework.stereotype.Component;
 
 @Component("TestActivityImpl")
-@ActivityImpl(workers = "mainWorker")
+@ActivityImpl(workers = "${default-worker.name:mainWorker}")
 @Profile("!auto-discovery-with-profile")
 public class TestActivityImpl implements TestActivity {
   @Override

@@ -4,7 +4,7 @@
 import io.temporal.spring.boot.WorkflowImpl;
 import io.temporal.workflow.DynamicWorkflow;
 
-@WorkflowImpl(workers = "mainWorker")
+@WorkflowImpl(workers = "${default-worker.name:mainWorker}")
 public class TestDynamicWorkflowImpl implements DynamicWorkflow {
   @Override
   public Object execute(EncodedValues args) {

@@ -8,7 +8,7 @@
 import org.springframework.stereotype.Component;
 
 @Component("TestNexusServiceImpl")
-@NexusServiceImpl(workers = "mainWorker")
+@NexusServiceImpl(workers = "${default-worker.name:mainWorker}")
 @ServiceImpl(service = TestNexusService.class)
 public class TestNexusServiceImpl {
   @OperationImpl

@@ -9,7 +9,7 @@
 import org.springframework.context.ConfigurableApplicationContext;
 import org.springframework.context.annotation.Profile;
 
-@WorkflowImpl(workers = "mainWorker")
+@WorkflowImpl(workers = "${default-worker.name:mainWorker}")
 @Profile("!auto-discovery-with-profile")
 public class TestWorkflowImpl implements TestWorkflow {
 

@@ -109,6 +109,23 @@ spring:
       register-activity-beans: true
       register-nexus-service-beans: true
 
+---
+spring:
+  config:
+    activate:
+      on-profile: auto-discovery-by-worker-name-dynamic-name
+  temporal:
+    workers:
+      - task-queue: PropertyResolverTest
+        name: propertyResolverWorker
+    workers-auto-discovery:
+      workflow-packages:
+        - io.temporal.spring.boot.autoconfigure.byworkername
+      register-activity-beans: true
+      register-nexus-service-beans: true
+default-worker:
+  name: propertyResolverWorker
+
 ---
 spring:
   config: