diff --git a/CHANGELOG.md b/CHANGELOG.md
index d639bc4d..d45c1024 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- [fj-doc-lib-direct] add useChainId param for chain alias <https://github.com/fugerit-org/fj-doc/pull/406>
+
 ## [8.13.4] - 2025-04-25
 
 ### Added
diff --git a/fj-doc-lib-direct/src/main/java/org/fugerit/java/doc/lib/direct/VenusDirectFacade.java b/fj-doc-lib-direct/src/main/java/org/fugerit/java/doc/lib/direct/VenusDirectFacade.java
index f52daf30..6ff10491 100644
--- a/fj-doc-lib-direct/src/main/java/org/fugerit/java/doc/lib/direct/VenusDirectFacade.java
+++ b/fj-doc-lib-direct/src/main/java/org/fugerit/java/doc/lib/direct/VenusDirectFacade.java
@@ -76,7 +76,8 @@ public static void handleOutput(VenusDirectConfig config, String outputId) {
                 log.info( "mkdir: result:{}, directory:{}", outputFile.getParentFile().mkdirs(), outputFile.getParentFile() );
             }
             try ( FileOutputStream fos = new FileOutputStream( outputFile ) ) {
-                config.getDocProcessConfig().fullProcess(chain.getChainId(), context, output.getHandlerId(), fos );
+                log.info( "generate outputId:{}, chainId:{}", outputId, chain.getChainId() );
+                config.getDocProcessConfig().fullProcess( chain.resolveChainId(), context, output.getHandlerId(), fos );
             }
         } );
 
diff --git a/fj-doc-lib-direct/src/main/java/org/fugerit/java/doc/lib/direct/config/VenusDirectConfigChain.java b/fj-doc-lib-direct/src/main/java/org/fugerit/java/doc/lib/direct/config/VenusDirectConfigChain.java
index ad27e06f..0a3accab 100644
--- a/fj-doc-lib-direct/src/main/java/org/fugerit/java/doc/lib/direct/config/VenusDirectConfigChain.java
+++ b/fj-doc-lib-direct/src/main/java/org/fugerit/java/doc/lib/direct/config/VenusDirectConfigChain.java
@@ -6,6 +6,7 @@
 import lombok.Setter;
 import org.fugerit.java.core.function.SafeFunction;
 import org.fugerit.java.core.io.FileIO;
+import org.fugerit.java.core.lang.helpers.StringUtils;
 
 import java.util.LinkedHashMap;
 
@@ -18,6 +19,9 @@ public class VenusDirectConfigChain {
     @Getter @Setter
     private String chainId;
 
+    @Getter @Setter
+    private String useChainId;
+
     @Getter @Setter
     private LinkedHashMap<String, Object> dataModel;
 
@@ -36,4 +40,8 @@ public void setupDataModel() {
         }
     }
 
+    public String resolveChainId() {
+        return StringUtils.valueWithDefault( this.getUseChainId(), this.getChainId() );
+    }
+
 }
diff --git a/fj-doc-lib-direct/src/test/resources/config/venus-direct-config-1.yaml b/fj-doc-lib-direct/src/test/resources/config/venus-direct-config-1.yaml
index fd606fc6..2309b21c 100644
--- a/fj-doc-lib-direct/src/test/resources/config/venus-direct-config-1.yaml
+++ b/fj-doc-lib-direct/src/test/resources/config/venus-direct-config-1.yaml
@@ -12,8 +12,10 @@ chainList:  # a template named ${chainId}.ftl must exist in 'templatePath' folde
       docTitle: 'Venus Direct Extension - Test Doc'
   - chainId: 'test-doc-json-data-model'
     dataModelJson: 'src/test/resources/data-model/data-model-1.json'  # JSON file data model
+    useChainId: 'test-doc'
   - chainId: 'test-doc-yaml-data-model'
     dataModelYaml: 'src/test/resources/data-model/data-model-1.yaml'  # YAML file data model
+    useChainId: 'test-doc'
 outputList:
   - outputId: 'test-doc-html'
     chainId: 'test-doc'
@@ -30,4 +32,4 @@ outputList:
   - outputId: 'test-doc-yaml-data-model-md'
     chainId: 'test-doc-yaml-data-model'
     handlerId: 'md'
-    file: 'target/test-doc-json-data-model.md'
\ No newline at end of file
+    file: 'target/test-doc-yaml-data-model.md'
\ No newline at end of file
diff --git a/fj-doc-lib-direct/src/test/resources/template/test-doc-json-data-model.ftl b/fj-doc-lib-direct/src/test/resources/template/test-doc-json-data-model.ftl
deleted file mode 100644
index cfef8286..00000000
--- a/fj-doc-lib-direct/src/test/resources/template/test-doc-json-data-model.ftl
+++ /dev/null
@@ -1,44 +0,0 @@
-<#ftl output_format="XML">
-<?xml version="1.0" encoding="utf-8"?>
-<doc
-        xmlns="http://javacoredoc.fugerit.org"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:schemaLocation="http://javacoredoc.fugerit.org https://www.fugerit.org/data/java/doc/xsd/doc-2-1.xsd" >
-
-    <!--
-        Sample Apache FreeMarker template for Fugerit Doc.
-        Note : this example has no intention of being a guid to FreeMarker
-                (In case check FreeMarker documentation https://freemarker.apache.org/docs/index.html)
-     -->
-
-    <meta>
-
-    <!-- Margin for document : left;right;top;bottom -->
-    <info name="margins">10;10;10;30</info>
-
-    <!-- id table to be used for xlsx output -->
-    <info name="excel-table-id">excel-table=print</info>
-    <info name="excel-width-multiplier">450</info>
-    <!-- id table to be used for xsv output -->
-    <info name="csv-table-id">excel-table</info>
-
-    <!-- you need to escape free marker expression for currentPage -->
-    <footer-ext>
-        <para align="right">${r"${currentPage}"} / ${r"${pageCount}"}</para>
-    </footer-ext>
-
-    </meta>
-
-    <body>
-    <h head-level="1" >${dataModel.docTitle}</h>
-    <para>${.output_format} - ${testKey!'not present'}</para>
-    <table columns="3" colwidths="30;30;40"  width="100" id="excel-table" padding="2">
-        <row>
-            <cell align="center" border-color="#ee0000" border-width="1"><para style="bold">Name</para></cell>
-            <cell align="center"><para style="bold">Surname</para></cell>
-            <cell align="center"><para style="bold">Title</para></cell>
-        </row>
-    </table>
-    </body>
-
-</doc>
\ No newline at end of file
diff --git a/fj-doc-lib-direct/src/test/resources/template/test-doc-yaml-data-model.ftl b/fj-doc-lib-direct/src/test/resources/template/test-doc-yaml-data-model.ftl
deleted file mode 100644
index cfef8286..00000000
--- a/fj-doc-lib-direct/src/test/resources/template/test-doc-yaml-data-model.ftl
+++ /dev/null
@@ -1,44 +0,0 @@
-<#ftl output_format="XML">
-<?xml version="1.0" encoding="utf-8"?>
-<doc
-        xmlns="http://javacoredoc.fugerit.org"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:schemaLocation="http://javacoredoc.fugerit.org https://www.fugerit.org/data/java/doc/xsd/doc-2-1.xsd" >
-
-    <!--
-        Sample Apache FreeMarker template for Fugerit Doc.
-        Note : this example has no intention of being a guid to FreeMarker
-                (In case check FreeMarker documentation https://freemarker.apache.org/docs/index.html)
-     -->
-
-    <meta>
-
-    <!-- Margin for document : left;right;top;bottom -->
-    <info name="margins">10;10;10;30</info>
-
-    <!-- id table to be used for xlsx output -->
-    <info name="excel-table-id">excel-table=print</info>
-    <info name="excel-width-multiplier">450</info>
-    <!-- id table to be used for xsv output -->
-    <info name="csv-table-id">excel-table</info>
-
-    <!-- you need to escape free marker expression for currentPage -->
-    <footer-ext>
-        <para align="right">${r"${currentPage}"} / ${r"${pageCount}"}</para>
-    </footer-ext>
-
-    </meta>
-
-    <body>
-    <h head-level="1" >${dataModel.docTitle}</h>
-    <para>${.output_format} - ${testKey!'not present'}</para>
-    <table columns="3" colwidths="30;30;40"  width="100" id="excel-table" padding="2">
-        <row>
-            <cell align="center" border-color="#ee0000" border-width="1"><para style="bold">Name</para></cell>
-            <cell align="center"><para style="bold">Surname</para></cell>
-            <cell align="center"><para style="bold">Title</para></cell>
-        </row>
-    </table>
-    </body>
-
-</doc>
\ No newline at end of file