I have some custom python functions I have defined in QGIS which I use in print composer. I tried copying the python folder into the QGIS Server path but they do not get propagated. I have seen the following http://osgeo-org.1560.x6.nabble.com/QGIS-Developer-Custom-python-expressions-in-QGIS-Server-td5362875.html but the answer seems vague to me. Any hints / documentation or that I could read on this anyone out there with an example that I could look at.

1 Answer 1


I have tried quickly by writing a quick QGIS Server plugin and it worked. I have followed the link you gave more or less.

  1. Make a folder called ServerExpression for instance.

  2. In this folder, add a quick metadata.txt:

     name=Server expression
     description=Expose Python expressions on QGIS Server
     about=Expose Python expressions on QGIS Server
     author=Etienne Trimaille
     [email protected]
  3. In this folder, add a __init__.py:

     from qgis.core import QgsMessageLog, Qgis, QgsExpression
     from qgis.utils import qgsfunction
         args='auto', group='Your group', usesGeometry=False, referencedColumns=[], helpText='Define the help string here')
     def your_expression(params, feature, parent):
         # UPDATE the qgsfunction above
         return params.upper()
     class ServerExpressionPlugin:
         def __init__(self):
             QgsMessageLog.logMessage('Loading expressions', 'ServerExpression', Qgis.Info)
     def serverClassFactory(serverIface):
         _ = serverIface
         return ServerExpressionPlugin()
  4. Transfer this folder in the plugin directory on the server, reload QGIS Server if needed

  5. If in your layout, you have a label with


You will have a PDF with HELLO.

To make things easy, I have added all the code in the __init__.py. Of course, you can make your Python files listing your expressions, to make it easier to copy paste between Desktop and Server.

  • Thanks, I will try it. I am using docker to run qgis server. Yes the 3liz docker container Mar 27, 2020 at 16:59
  • I have created the server plugin in QGIS plugin path but the functions do not get registered. I am using 3liz/qgis-map-server:3.10 Mar 27, 2020 at 18:00
  • Do you have any server plugin already which are working?
    – etrimaille
    Mar 30, 2020 at 8:13
  • @etrimaille, THANKS a lot ... you saved my day with this answer! Now I have a full functional QGIS 3.16 server on Windows 2016 serving beautiful wavy, wiggly lines - gis.stackexchange.com/questions/376411/… ... I owe you a BIG beer!
    – christoph
    Dec 2, 2020 at 9:10

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.