There are quite a few configuration options for dataset pages. This page will only go into details for adding, modifying, and removing features and feature properties (and what happens when you make changes to an existing dataset). A full list with descriptions for all configuration options can be found on the Dataset Configuration page.

Features

To add a feature:

1. Click the Add New Feature button on the Features tab. (The new feature will be added to the bottom of the list.)
2. Set valid coordinates. Coordinates are required in order to save the page in the first place, but if they are not valid the new feature will be removed from the list when the page is saved. Features in point datasets require a longitude and latitude, while features in shape datasets require an appropriate array of longitudes and latitudes (matching GeoJSON coordinate format).
3. Optional: Set other values, like custom name, values for properties, or popup content. You can always add or modify these values later.

All feature values can be modified. The most important thing to remember is that the coordinates must be valid. If you replace a feature's coordinates with an invalid value, the feature's coordinates will revert to their previous (valid) value when you save the page. Newly added features with invalid coordinates are removed from the features list because there are not valid coordinates for the feature to fall back on.

Note: Updating a feature with invalid coordinates will not prevent updating other values of that feature. For example, if you try to update a feature's coordinates and popup content, the popup content will be modified regardless of the validity of the new coordinates.

You can also remove features, but be careful since this cannot be undone. It is recommended to use something like git sync so you can revert potentially destructive changes.

Properties

Each dataset has a list of properties. When you add or remove properties (and save the page), all other fields listing available properties will be updated to match. Be careful about removing properties from the list. The property will also be removed from all features, so make sure you won't lose any important data.

You can also rename properties by filling out a new valid name (i.e. a non-empty name that does not match an existing property in the dataset) in the Rename Properties fieldset. The property will be updated everywhere it is used, including the dataset's properties list, the dataset's name property and auto popup properties, all feature properties, and even any tours overriding the dataset's auto popup properties.

Modifying a Dataset in Use

Tours can reference specific datasets, and both tours and views can reference specific features from a dataset. This means that modifications to a dataset have the potential to disrupt existing tours using that dataset. Therefore, when a dataset page is saved, any tours (and their views) using that dataset are also updated to remove references to invalid features. If this goes wrong for any reason, you should see the name of the feature as "Invalid, please remove" or something similar, and can remove the feature from the tour or view manually.

If you delete a dataset page, tours (and their views) will be modified to remove references to both the dataset as a whole and any of its features.

If you delete a dataset created by uploading a file to the plugin configuration, the uploaded file will also automatically be deleted. The next time you save the plugin config, the reference to the deleted file will be removed. In other words, the uploaded file will be dealt with automatically, so you do not need to worry about it.