Release information and news about CityPlanner

CityPlanner Next / Legacy status

It’s been a while since the last news post, so we thought it’s time to update you all on the status of CityPlanner Next and Legacy.

CityPlanner Next is planned to completely replace Legacy by the end of the year.

Right now, here’s where we are at:

  • CityPlanner Offline supporting Next portals & projects – Preparing for Beta test by invitation. If you have an Offline license, you are eligible for the Beta test.

Missing legacy features currently in development:

  • FadeIn/FadeOut, Distance visibility interactions
  • Search admin & frontend UI

Missing legacy features soon to start development:

  • Export 3D model
  • Export Dialogue answers
  • Default setting for graphics profile and interface
  • Integrated News & Support system

Once the legacy features are implemented, we’ll start the migration process of projects on legacy to Next.

// The CityPlanner team


Important changes to CityPlannerOnline

Today, we’re launching the new version of CityPlanner (“Next”) on We happy to finally complete the move to a plugin-free HTML5/WebGL technology platform. The new version of CityPlanner has a completely redesigned UI and workflows, better performance and lots of new exciting features. Just login with your CityPlanner user to start working in the new version of CityPlanner.


We are still adding features every month to the new version and some features from the legacy version of CityPlanner has not yet been added to the new version.

Also, projects created with the legacy Java editor hasn’t yet been migrated. If you need to access your java editor projects, click the Legacy button from the CityPlanner landing page or go directly to and login.

Legacy project migration will start in the fall, contact us if you need more information.

Beta test open for CityPlanner “Next”


We’re happy to open up the preview version of the new CityPlanner Editor to existing CityPlannerOnline users. We have been working on this major upgrade of CityPlanner for about a year so we are excited to finally let the public beta test begin. Codenamed “Next”, the new CityPlanner is a ground up redesign and redevelopment of the editor and the admin experience in general.

About the open Beta:

  • Don’t expect everything to work just yet. Things might break but don’t worry, that’s normal. Let us know what’s broken and we’ll fix it.
  • Use for evaluation, training & test but not for projects that you actually want to publish publicly.
  • Give us lots of feedback on everything. Use the form in the help-pages to send us feedback.

To access Next, go to and login with your user/password from CityPlannerOnline.

Have fun exploring “Next”!

Agency9 Team


WebGL Editor teaser movie

We’re making great progress on the upcoming WebGL Editor and want to show some live action from the editor. So here’s a short teaser movie that shows:

  • Overall layout and component interactions
  • Choosing background
  • Adding startview and viewpoints
  • Setting up project description and adding images with drag & drop
  • Adding simple Points of interest

Let us know what you think: or

CityPlanner Online and Offline updated

CityPlanner has been updated with primarily bug fixes and minor improvements.

Offline bug fixes:

  • Offline shadow control month text not visible
  • Layers set to admin access visible when they should not be. Now layers must be set to access: All to show up in Offline
  • Offline can get stuck with blur filter
  • Portal with no projects breaks in autopilot
  • Offline with Portals and Projects with WMS can freeze
  • Offline can crash after long period of time in autopilot
  • Dialogue category labels gets cut off, line height to small
  • Custom layer and viewpoint button texts in portal projects not shown
  • Attribute window not shown

Offline new features:

  • Offline setting for language. You’ll find it in Settings.exe under Language (Swedish and English)
  • Gzipped A3X background data now works in Offline

To update Offline, just run the sync.exe application and you should get these updates. If you haven’t updated in a very long time, make sure you have a sync application that’s newer than June 2015 – if not, you might have to download the sync application from your account page before updating.

Online bug fixes:

  • Project icons in Portal takes a long time to load.
  • 4D delete all imported projects not working
  • 4D update imported projects makes duplicates
  • Dialogue suggestion panel too wide on small resolutions – should shrink to single column

Online new features:

Project icon in Portal has been updated with a new design for shape and default color and icon.

The project icon color can be changed in:
Portal->General settings->Customize->Design

The inner icon can be customized for each project from the Editor:
Project editor->Settings->Portal settings->Use custom icon





New Editor early screenshots

As you might know, we’ve been hard at work the last six months redesigning the Editor from the ground up. We started by surveying our users on how they would like the CityPlanner experience and work flow to be like and also asked them to help us prioritize features. The result of the survey, along with years of experience developing CityPlanner, gave us a list of targeted features and user experience goals.

With the new Editor we want to improve usability, shorten task completion time, support instant previewing for all content, build a modular GUI and backend structure to support adding features without cluttering the interface, and much more.

We want the Editor experience to be much more like a desktop application than a web page with support for common features that you’d expect from any application such as:

  • Undo/Redo
  • Duplicate
  • Select/Multi-select to edit
  • Drag&Drop to add content
  • Powerful and secure collaboration

Here’s a first look at where we’re heading:

Editor is everything

Everything is created in and accessed from the Editor. No more switching between admin pages to find the setting you were looking for. After login, you’re in the editor and you’ll open or create projects from inside the Editor.


Editor layout

Here’s how the Editor is organized. The Editor toolbar is visible for editing users. Each tool icon is a grouping of similar features, such as Viewpoints & Tours.


Edit and Preview simultaneously
Click on content to edit and then preview the change instantly. The Editor will show you what a change will look like straight away without you having to exit the Editor or switch modes.


Object Manager

The object manager helps you organize your content into groups, layers, and objects. It also lets you control which content is accessible to team members and public users. The object manager is the backbone of your project, anything that is related to the project will show up here for easy access and review.


We’ll start inviting alpha testers beginning of 2016 and then release it in steps under 2016.

That’s it for this preview!

We’re really exited about the new Editor. What do you think? Let us know, drop us feedback at or




Graphic design tutorial

There are many design elements you can customise in CityPlanner. This is an overview of what you can modify along with tips for making your project look as as good as possible.

  • Vector Graphics

    • The SVG image format is recommended for uploading icons and logos to CityPlanner. SVG is a vector graphics format, which means that as images scale they retain sharpness regardless of screen size or resolution.


      Image formats: Vector vs Raster

    • If you lack vector assets, you can use Vector Magic to automatically convert images from raster formats such as PNG, GIF, and JPG.
    • Inkscape is a free open-source program for Windows and Mac OS which can be used to edit and convert vector formats. Commercial options include Adobe Illustrator and CorelDRAW.
    • Protip: Using vector graphics is extra important for projects published to 4K, Retina, and mobile screens.
  • Masthead

    • The Masthead is the logo or wordmark of your city. It lives in the top left corner of the CityPlanner interface and serves as the chief way to brand your project.

      CityPlanner Masthead

      CityPlanner Masthead

    • Manage the Masthead under General Settings | Design:

      Admin Logo

      Admin Masthead

    • Protip: When using an image with a transparent background, it is recommended to use a white logo/wordmark with a subtle drop shadow. White stands out best over city models and the drop shadow preserves visibility over light backgrounds such as sky.
    • Recommended image size for the Masthead is less than 200×200px.
  • Ribbon Logos & Icons

    • The Ribbon is the button group which runs along the bottom of the interface.

      Ribbon: Logo & Icons

      Ribbon: Logo & Icons

    • All of the logos and icons can be customised. The leftmost button is the “Logo Button”. By default it features the CityPlanner logo but it is designed to be replaced with your city logo/shield.

      Logo Button Examples

      Logo Button Examples

    • Upload custom logos and icons on the CityPlanner Admin page, under the General Settings | Ribbon & General Settings | Dialogue tabs:
      Admin Page: Ribbon Icons

      Admin Page: Ribbon Icons

      Admin Page: Ribbon Icon Dialogue

      Admin Page: Ribbon Icon Dialogue

    • It is recommended to use single colour white icons between 45-55px squared.
  • Typography

    • CityPlanner supports custom typography using the @font-face CSS rule. Click here to learn more about @font-face.
    • There are three fonts groups you can customise – 1) Buttons 2) Headings and 3) Paragraphs:

      Project View Typography

      Project View Typography

    • To add custom type to your project, you can link to a remote stylesheet from the CityPlanner Admin page, under General Settings | Design:

      Admin Typography

      Admin Typography

    • Protip: You need to upload the stylesheet and font files to your own server.
  • Colour Palette

    • Setting a Theme Colour is one of the key ways of branding your project. It highlights active and hovered interface elements.

      Project Colour Examples

      Theme Colour Examples

    • The Complementary Colour is used for Dialogue suggestions and creations.
      Complementary Colour: Points of Interest

      Complementary Colour: Points of Interest

      Complementary Colour Suggestion

      Complementary Colour: Suggestion & Creation

    • Set your custom palette on the CityPlanner Admin page, under General Settings | Design:

      Admin Colour

      Theme & Complementary Colour

    • Protip: Be mindful of using very light hues as it can make the white text difficult to read.
  • Default Settings

    • As there are so many ways in which a project can be customised with your civic profile, CityPlanner allows for saving all customisations to the account.

      Saving & Reseting Custom Settings

      Saving & Reseting Custom Settings

    • When clicking 1) Use As Default everything in the General Settings | Customise section (all tabs) is saved.
    • Protip: You need be an Account Admin to set the default.
    • Future projects henceforth begin with these settings. Previously created projects can be manually updated to the new defaults by opening each project and clicking the 2) Reset button.

Good luck designing your project!

Getting started with Form Builder

With Form Builder, you can add your own unique forms to any CityPlanner project or portal. This functionality is part of the Dialogue add-on module and the new Project 2016 interface.

1. Activate Dialogue

  • Start by creating a new project or opening an existing project.
  • Make sure the Project 2016 interface is selected in General settings.
  • Click Dialogue settings.
  • Check Enable Dialogue to activate the module on this project.
  • Click Save and go back to the project page.



2. Build the Form

  • Form Builder lets you build the dialogue form interactively with instant preview.
  • Sections are basically the pages in the form. The sections can have a start view, title and components.
  • You can add, remove and reorder sections by dragging and dropping them.

Form components

  • Components are added to a section by dragging them into the section. You can reorder components by dragging and dropping them.
  • After you drag a component to a section, you can edit the component properties.
  • Any component can be set to be mandatory or not to submit the form.

Click a component from the list below for more information:


The Information component is used to display instructions or other one-way information to the user.


You can add questions with different reply types such as text area or single line, as well as allowing single option and multiple option answers.

Create toolbox

The Create component adds draw tools to the form. You can customize the names of the tools to best suit your project and choose which ones to include. By default the user can mark positions, draw lines and areas.


  • Drag the Category component to the section you wan to use it in. Categories can only be used once in a form.
  • Categories have a title, color and in future versions an icon.
  • You can set the component to switch to the Marker tool automatically when the user selects a category.


You can allow the user to upload and attach files by using the Attachment component.

Text field

The Text Field component is a text area with optional instructions or text used as placeholder. It disappears when the user clicks on the field.  You can set the size of the area to fit the input.


This component lets you ask questions with smiley faces as answer options. It can be used to ask questions in a more friendly way or in projects targeting a younger audience.

User information

This component lets you configure what you want the respondent to enter about themselves. Field labels can be customized and you can set which fields are mandatory to submit the form.

After Submit settings

  • Here you can edit what is shown to the user after a form has been submitted.
  • Set if you want submissions be published automatically or after admin approval.
  • Submitted forms can automatically be sent in an email to an address you configure. You can also specify a second address which only receives submissions with the Legal Submission checkbox checked.

3. Publish the form

  • Customize the button labels and icons in the General settings->Customize->Dialogue.
  • Set the Form to Published in Form Builder.
  • To moderate submissions, you need to be logged in and open the project view. A button appears when viewing a suggestion which lets you publish or unpublish the submission.


Here’s how it looks like to the end user

Major update – Project 2016, Form Builder & Offline released

We are very excited to finally release these major improvements and new features today:

Project 2016

The new user interface has been officially released and is now the default UI for all CityPlanner projects.

Project 2016
Form Builder

The Dialogue module has been upgraded with the Form Builder feature which allows you to completely build and customize forms to suit your project’s specific needs.

Form Builder

The Offline module is updated to use the same Project 2016 UI and supports Dialogue if Internet access is available.


Exciting stuff!

More tutorials and info will follow shortly. Let us know what you think, and don’t hesitate to use the Support form if you need assistance.


  • Touchpad and 1-mouse button support. Press key modifiers CTRL, SHIFT, ALT while moving the mouse for Move, Zoom, Rotate & Tilt actions.
  • Account admin can set a custom default Graphics profile and project settings.
  • Performance and other bug fixes.


Stockholm Dialogue project showcasing new beta features

The city of Stockholm has launched a public dialogue project, built with the upcoming Form Builder tool. The dialogue form is using new survey components to engage citizens and stakeholders in early dialogue about the public areas in the Kolkajen-Ropsten urban development project.

When taking the survey, the user is guided through the area and asked questions how five public locations should be planned for use. In the survey, the user can choose to add their age, gender and where they live to the submission. There is of course also a 3D model of the planned area and other important information about the project. Users can read other peoples suggestions, indicate if they agree or disagree and share them via Facebook, Twitter, LinkedIn or Email.

(Note: this project is in Swedish)


Project info window shown at startup


Overview with viewpoints, points of interest and 3D model visualising the plan


All suggestions are available in a list


Viewing a suggestion from someone else. Agree/Disagree and Share.


Example of one of the questions in the survey. The user is guided through the plan, answering questions.

The Form Builder has drag and drop components used for customizing the form

The Form Builder has drag and drop components used for customizing the form