Importing and exporting your theme and manifest file (Guide Professional and Enterprise)

Have more questions? Submit a request

25 Comments

  • Shammel

    I'm trying to use ZAT locally but it says I have to first export a theme. I don't see the option to export or import. Our plan is Guide (legacy) and is currently greyed out (we can't change the plan).

    Any help is appreciated.

    0
  • Alicia Gonzalez

    Hey Shammel! Could you share a screenshot on the options that you see?

     

    0
  • Shammel

    Hi, Alicia. I see the new UI now. It said it would be working yesterday (11.20.2017) but it seemed to kick in today. Thanks!

    1
  • Nicole - Community Manager

    Glad to hear you got things working, Shammel! 

    Also, I see that this is your first post - Welcome to the Zendesk Community! I encourage you to head over to the Welcome Thread in The Lounge to introduce yourself.

    We look forward to seeing you around the Community. Happy Zendesking!

    0
  • Steve Morrell

    We have a new theme that we have been working on in the sandbox. It includes images in the assets.

    We have exported that theme, and imported it into production. It all works, and the assets are imported, but none of them appear in the display.

    I have tried replacing them, deleting and re-adding them, but no luck.

    Thoughts?

    Steve

    0
  • Ryan McGrew

    Hi @Steve,

    I've followed up with a ticket so we can get things taken care of.

    Thanks!

    0
  • tcorneliusart

    Hi, 

    I have a two questions:

    Does a custom theme zip file need to contain the same folder structure as the Copenhagen theme? 
    Does my html syntax need to match what is used in the Copenhagen theme?

    Am I able to import my own fonts?

    Thanks

     

    0
  • Ryan McGrew

    Hi!

    Yes, the folder structure will need to be the same for all themes.

    Not sure exactly what you mean, but the HTML of the templates, CSS and JavaScript can be completely customized you just need to use the templating language we provide

    Yes, you can use your own fonts! Just include them as an asset and use the $asset helper in CSS to use them. Here's an article on that. 

    Thanks!

    0
  • Don Clark

    I'm trying to export a theme from my production instance and import it into another "brand" - every time I try, I get a (very brief) toast message saying either "There was an error" or "This file type is not supported: <filename>.eot." 

     

    0
  • Nicole - Community Manager

    Hey Don -
    I see that you're getting answered in a private ticket, but let us know if you have any further questions!

    0
  • Sergio Anarte

    Hi guys, 

    Does anybody know if we could export these files using Help Center API?

    Thanks!

    0
  • Dwight Bussman

    Hi Sergio,

    I don't believe we've exposed any API methods to interact with the Theming information. If that's something that you'd really like to see as part of our software, I recommend posting this feature request to our Product Feedback Forums so that other users can vote & comment in support of the idea and Product Managers can gauge how best to prioritize development efforts.

    Thanks!

    0
  • Stephen

    Hello,

    I'm experiencing the same issue as Don Clark above.  Has there been a fix to this issue?

     
    February 06, 2018 16:15
     

    I'm trying to export a theme from my production instance and import it into another "brand" - every time I try, I get a (very brief) toast message saying either "There was an error" or "This file type is not supported: <filename>.eot." 

    0
  • Ryan McGrew

    Hi Stephen,

    That should be fixed. Not sure what's happening here. I'll file a ticket and we can figure it out there. 

    Thanks!

    0
  • Sumaiya Afzal

    Hello

    I'm trying to export our current Theme but I can't find the Themes Export setting as described here. Is this only available for the new Theming experience? We haven't migrated to the new Theming experience yet. 

    I need a way to export/bulk download our theme assets that are no longer supported.

    Thanks! 

    0
  • Ryan McGrew

    Hi Sumaiya,

    Yes, export is only supported via the new theming experience. However, if you have less than 100 MB of assets you can still migrate to the new experience with your these assets. You can then export the theme and make your update from there in the new theming experience.

    Thanks!

    0
  • Kelsey Hales

    Hey, is doing a manual export of the theme the best way to implement version control of the Help Center? If that's the best method, could we have that added to the API so we can make our own version control scripts? 

    2
  • Ryan McGrew

    Hi Kelsey, 

    We see a few ways of doing this. I think the primary workflow would be to export your current them and check it into a repository using your favorite version control software. We use github here at Zendesk. From there, we'd recommend using our local preview tools to work from your local machine. Then as you make updates you can push the changes into your repository.

    When you're happy with the changes locally, go ahead and zip them up and import it to Guide.

    You can also work the reverse way, and do your development in the web based editor and then exporting out the changes and checking them into your repository.

    Thanks!

    0
  • Muhammad Alyas

    Hi,

    I am trying to import a theme (which I exported earlier) , but getting error message "Failed to Import: Please upload a valid zip file under 30 MB".

    My theme zip file is valid and exported from the "customize design" screen using the export option.

    is there anything else needed?

    Thanks

    0
  • Augusto Cravo Silva

    Hi @Muhammad,

    If this theme was migrated from the old customization experience, it is possible that it is above the limit. The new experience does not allow new themes above 30 MB.

    You can check if that is the case by going to Edit Code and then checking the space used by your assets at the bottom of the file tree. Alternatively, check the ZIP file you exported to see what is its size.

    Please try to remove no longer used assets to make the theme smaller than the limit.

    Hope this helps

    0
  • Muhammad Alyas

    @Augusto Thanks for response.

    It sure is below 30 MB, actually it's just ~1 MB. and it's exported using current interface.

    Thanks.

    0
  • Jenesses Caberio

    I also experienced importing a theme which is just 329kb (zip file). The error was "Please upload a valid zip file under 30 MB. I exported the theme from our production instance and was trying to import it to our sandbox.

    This was fixed by using Chrome incognito window on export and import theme.

    0
  • Jessie - Community Manager

    Thank you for sharing, Jenesses!

    0
  • Brendan Farrar-Foley

    When I export a theme from the main Zendesk Help Center and attempt to import it into the sandbox, I get errors about filenames with illegal characters.  They flash up rather than displaying so I can copy the errors somewhere I can research.  

     

    Why doesn't the export from the help center import properly?  This doesn't make sense.  

    0
  • James Sanford

    Hey Brendan!

    It sounds like you're running into the error "The file you attempted to upload has illegal characters in the file name. Filenames should only have alpha-numerical characters, _, -, and +."

    As an initial suggestion for anyone else reading this and experiencing similar issues I would encourage a review of your file names to ensure they do not contain restricted characters or spaces.

    To ensure we can get this working for you Brendan I am going to create a ticket so I can review this in greater detail with you.  Please keep an eye out in your email so we can take a look at this - thanks!

    0

Please sign in to leave a comment.

Powered by Zendesk