I have a plugin that I am writing and I want to make available a macro that can be used within the front end sites templates. What is the best way to do that?

  • 1
    Do you need to specify it as a macro or would a Twig function work, too?
    – Victor
    Jun 22, 2014 at 19:14
  • What are you trying to do with the macro? What purpose is it serving? Jun 22, 2014 at 20:01
  • @VictorIn, twig functions could probably work, however it doesn't feel right having several lines of markup within PHP classes.... Jun 22, 2014 at 20:29
  • @ChrisMancini Can you add an example of what you are trying to do to your question?
    – Victor
    Jun 22, 2014 at 20:31
  • 1
    @BryanRedeagle, I see many use cases for this sort of functionality, but my first use case is for forms that need to be submitted that are core to my plugins functionality. The end user could invoke the macro passing through a few required / optional parameters and it renders accordingly. Similar to how we can use Craft form macros within our plugins CP. Jun 22, 2014 at 20:31

1 Answer 1


I'm not aware of this being possible. The control panel uses a different template path than the front end. This makes plugin templates generally inaccessible. One possible option is to create a template variable that runs a macro or renders a template on behalf of the user. Something like:

{{ craft.pluginHandle.macro(arguments) }}

You will need to make sure that the template path is set to the Control Panel so that your macro can be found, and that it's set back afterwards. At the start of the function set this:


Then when you are done rendering your macro (preferably to a variable to return later), you set it back:


  • So, I just attempted this, but renderMacro seems to only have access to the front end template path, even when doing it through template vars. :-/ Jun 23, 2014 at 1:41
  • My bad. I added a couple commands that will allow the plugin to find the macro template for rendering. Jun 23, 2014 at 2:04

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.