Skip to content
All admin lessons

Writing Box · Step-by-step lesson

Writing Box: links, pictures and documents

Add links, upload and resize images, attach documents and embed YouTube videos.

Before you start: Open a page or content item you can edit in the Admin Portal. These lessons demonstrate the existing Writing box controls.

How to use this lesson

Read the instruction, then look at the pointer on the example screen. Click or tap Next below when you are ready. The example screen is a demonstration. It cannot save, send or change anything.

“Select” means click once with a mouse, or tap once with a finger. You can go back, restart or take a break at any time.

Step 1 of 28

Open the page you want to edit

In the portal, select Pages, then click a page you can edit. The same Writing box is also used for News, Events, Emergency pages and Gateway content.

Look at the example. Then select Next when you are ready.

Step 1 of 28. Open the page you want to edit
Example screenAdmin Portal

Watch the pointer. Use the lesson’s Next button to continue.

Choose a different step
Read all instructions together
  1. Open the page you want to edit

    In the portal, select Pages, then click a page you can edit. The same Writing box is also used for News, Events, Emergency pages and Gateway content.

  2. Find the Writing box

    Scroll down to Writing box. This example already contains a sentence. Click inside the box to type your own content.

  3. Highlight the words for a link

    Select the words you want residents to click, such as Community Hub.

  4. Select Add link

    Click the chain-link icon in the toolbar.

  5. Select “Web address”

    Paste the full address of the page you want to link to.

  6. Enter web address

    Type your own details here. In this example, we have entered “https://example.org/community-hub”.

  7. Add the link

    Select Add link. The selected words become a link.

  8. Check the link

    The linked words are shown in the Writing box. Use meaningful words so residents know where the link will take them.

  9. Position the cursor for a picture

    Click where you want the picture to appear in the Writing box.

  10. Select Add image

    Click the picture icon. Choose an image in your device’s file picker, then select Open or Choose. Wait for the upload.

  11. Check the image

    The image is inserted at the text cursor. If an upload error appears, follow the message before continuing.

  12. Resize the image

    Drag the resize handle on the image’s lower right corner. The editor allows widths from 25% to 100% of the available space.

  13. Check the new width

    The image is now narrower. Choose a size that keeps the subject clear.

  14. Position the document link

    Click in the Writing box where you want the downloadable document link.

  15. Select Add document

    Click the document icon in the toolbar.

  16. Choose document

    Select a PDF or Word document within the upload limit shown by the editor. Select the file on your device, then select Open or Choose in your device’s file picker.

  17. Check the selected file

    Wait for the upload to finish. This example uses community-hub-information.pdf. Your device’s file picker may look different.

  18. Select “Link wording”

    Enter a clear label for the document link.

  19. Enter link wording

    Type your own details here. In this example, we have entered “Read the Community Hub information”.

  20. Insert the document

    Click Add document and wait for the upload to finish.

  21. Check the document link

    Residents use this link to open the uploaded document. Save the surrounding page to keep it.

  22. Position the video

    Click where you want the video in the Writing box.

  23. Select Add YouTube video

    Click the video icon. This control accepts YouTube links.

  24. Select “YouTube link”

    Paste the address of a suitable YouTube video. This training URL is a sample video, not community guidance.

  25. Enter youtube link

    Type your own details here. In this example, we have entered “https://www.youtube.com/watch?v=aqz-KE-bpKQ”.

  26. Add the video

    Check the preview, then click Add video.

  27. Check or remove the video

    The embedded video appears in the editor. Its × control removes it if you no longer want it.

  28. Save the page

    Click Save on the surrounding form to keep the link, document, image or video changes.

Written guides and troubleshooting