LEAD SECTION

Every new Shorthand story starts with a lead (or title) section.

Here you can change the text and media to suit the story. Hover over the main image area to reveal action buttons shown in green:

Click the top-left EDIT MEDIA button to change the background image:

Upload a new image by clicking on the representation of the existing one in the media panel, and choosing a new one from your computer. Set the focal point of the image by clicking a location on the overlaid grid. Different images may be uploaded for wide and tall screens but this is optional.

Title text position is changed with the on-screen arrows.

Change the text on the page by clicking on or highlighting the existing text and typing or pasting in your new text.

A foreground image or video may also be placed in the section by clicking the button above or below the title:

REORDERING SECTIONS

Sections of the story can be re-positioned by dragging them up or down the left side of the screen:

SECTION OPTIONS

Each section type supports a number of options that change its overall appearance such as background colour, text colour or animation. These settings can be accessed and changed with the cog icon next to each section thumbnail in the left-hand column:

^{More detail about section options here.}

REUSING SECTIONS

You can now duplicate sections not only to copy them to the story you're working on, but also to reuse them in any other story in your Workspace!

A copy of the section will be added to your own set of copied sections, which is accessible from the Add a Section panel:

^{More detail about copying sections here.}

To edit an existing story, locate it on your dashboard and click on the story image to be taken to the story editor.

To give other people access to a story you are working on, you can assign them access from the dashboard by clicking the 'Collaborate' button in the green flyout menu on the story card:

You can also assign collaborators from directly within the story editor, by clicking the green + icon at the top-right of the editor screen.

Collaborators can be assigned as viewers, editors, or owners of the story. In all cases, the story card will then appear on their Shorthand dashboard.

^{More detail about adding and working with collaborators here.}

SETTING THE META INFO

IMPORTANT: Properly setting this meta info is an important step to ensure good SEO

Click SETTINGS button at the upper left of the editor to open the 'Story Settings' menu.

1. Update the title.
   This picks up the article title from the first section of the story by default.  But if you want a different SEO title, you can enter it here. (Try to use words that people will use to search for a story like the one you created.)
2. Update the description.
   This picks up the article description from the first section of the story by default.  But if you want a different SEO description, you can enter it here. (Try to use words that people will use to search for a story like the one you created.)
3. Add author/s.
4. Add News Keywords
   Add search terms that people might enter to find this story

Ignore all the other fields!

IMPORTANT: In the Story Settings you may notice a 'PUBLISHING' section with a 'PUBLISHED URL' field. This field should be left empty as it does not control the URL a story is published to, and if you set a value to this field it will overwrite the proper canonical URL that should be associated with a story.

SETTING SOCIAL CARD INFO

Click SOCIAL button at the top of the editor (to the right of Settings) to open the 'Social Settings' menu

The following steps are optional:

1. Update the social card image.
   By default this will use the title image but, you can replace it with an image that you think might be more appropriate in a social card.
2. Update the social card title.
   By default this will use the story title.  But you can override it by entering new text.
3. Update the social card description.
   By default this will use the story subtitle.  But you can override it by entering new text.
4. The 'Show Facebook/Twitter button' options can be ignored, as can the Facebook App ID field.
5. You can add a specific image for the Twitter card if you like, as well as a specific description. Both of these will appear in the social card when tweeted but will fall back to anything added to the 'Social card' fields.
6. Twitter handle and Short URL fields can be ignored.

FINAL CHECK

Click the teal 'Preview' button in upper right to preview on desktop. There are additional options shown when the arrow on the right of the button is pressed.

Be sure to look at different break points, AMP, etc.

PUBLISHING

Click the blue 'Publish' button in upper right of the editor (or 'Republish' if it's already been published)

1. Look for the option “Direct Publish to Live Site”.
   IMPORTANT: IGNORE the option labelled 'Publish Embed for Shell Page'!
2. Confirm that the URL is SEO friendly – You can update it to improve it.
3. Copy that URL and save it, so you can enter it in the Drupal CMS
4. Click “Publish to this URL”

IMPORTANT: If you are publishing a story with an AMP version, once the publish process has finished you can click the 'Validate AMP page' button to check whether the AMP version is valid (the button links to this Google AMP validator). If there are any errors shown, Google will not index the AMP version of the story.