Export and self-host process
Your stories as downloadable ZIP files.
If your Shorthand plan offers .zip exports of your stories, you have considerable flexibility in how you publish, host or distribute them.
As a 'publishing' option, the .zip file enables you to download a compiled version of a story, consisting of only client-side technologies (HTML, CSS, JS and media) and ready to use. The ZIP file includes everything your story requires to render. Because you have all the elements, you can easily run the content through any post processing you require (eg you might inject custom tracking code, site navigation, or change URLs).
When you're ready to publish your story:
To download a ZIP:
- Find your story on the dashboard
- Click edit
- In the editor, click Publish
- Click Download ZIP
You will then begin a download of a ZIP folder that contains the static webpage code & media files, that you can host on your servers as a microsite.
Please note, if you are on a plan with a limited number of publishing credits each billing period, each export of a new story will reduce the remaining credits for your team as a whole.
ONCE YOU HAVE THE EXPORTED STATIC FILES OF YOUR STORY, IT’S IMPORTANT TO REMEMBER TO:
- Add your analytics code to the index.html (unless you already did this in Shorthand, which we would recommend)
- Check the social sharing settings are correct (these can only be properly tested once on the final URL)
- Check the story after uploading the export files to your server and configuring the CDN (if used) to ensure all content loads correctly.
To launch the story via an existing website, use the provided embed code for a story launcher. See more detail here.
If you have any questions or concerns regarding how your Shorthand story should be launched or delivered, please don't hesitate to contact us.
Other publishing options
Here is more information on other publishing options available, including WordPress and Drupal plugins, Shorthand hosting or access to our story API so that you can automate the story export workflow. Please contact us to discuss options.
See also: Pre-export checklist
We do not currently support using iframes to embed the story in your CMS or another platform, as this will likely cause some significant issues regarding how events and page re-sizing are handled in the story. We are currently working on further integrations with existing CMS and hosting providers. Wordpress and Drupal plugins are already available in beta.