diff --git a/sources/scripting/qetscriptapi.cpp b/sources/scripting/qetscriptapi.cpp
index 745b35ec7..b44b1c210 100644
--- a/sources/scripting/qetscriptapi.cpp
+++ b/sources/scripting/qetscriptapi.cpp
@@ -2378,6 +2378,55 @@ bool QetScriptApi::setFolioBorder(int folioIndex, const QString &property, const
 	return true;
 }
 
+/**
+	@brief QetScriptApi::elementGeometry
+	Where an element is: x and y are its origin (what setElementPosition()
+	sets), rotation is in degrees, and left/top/right/bottom are the box it
+	occupies on the folio, its drawn extent rather than its origin -- which
+	differs from it by the hotspot and, for a rotated element, is the
+	rotated extent. Empty if the element is not found.
+*/
+QVariantMap QetScriptApi::elementGeometry(int folioIndex, const QString &elementUuid) const
+{
+	QVariantMap g;
+	Element *element = findElement(folioIndex, elementUuid);
+	if (!element) return g;
+	const QRectF box = element->sceneBoundingRect();
+	g.insert(QStringLiteral("x"), element->pos().x());
+	g.insert(QStringLiteral("y"), element->pos().y());
+	g.insert(QStringLiteral("rotation"), element->rotation());
+	g.insert(QStringLiteral("left"), box.left());
+	g.insert(QStringLiteral("top"), box.top());
+	g.insert(QStringLiteral("right"), box.right());
+	g.insert(QStringLiteral("bottom"), box.bottom());
+	return g;
+}
+
+/**
+	@brief QetScriptApi::insertFolio
+	Add a folio at a position (0 is first, folioCount() is last) through
+	QETProject::addNewDiagram(pos) -- undoable. The position is checked
+	here: QETProject::addDiagram() hands it straight to QList::insert(),
+	which is undefined past the end.
+	@return the new folio's index, or -1
+*/
+int QetScriptApi::insertFolio(int position)
+{
+	if (!m_project) return -1;
+	if (m_project->isReadOnly()) {
+		log(QStringLiteral("qet.insertFolio: project is read-only"));
+		return -1;
+	}
+	if (position < 0 || position > m_project->diagrams().count()) {
+		log(QStringLiteral("qet.insertFolio: position %1 is outside 0..%2")
+			.arg(position).arg(m_project->diagrams().count()));
+		return -1;
+	}
+	Diagram *diagram = m_project->addNewDiagram(position);
+	if (!diagram) return -1;
+	return m_project->diagrams().indexOf(diagram);
+}
+
 int QetScriptApi::addFolio()
 {
 	if (!m_project) return -1;
diff --git a/sources/scripting/qetscriptapi.h b/sources/scripting/qetscriptapi.h
index 276a07663..20d9f007d 100644
--- a/sources/scripting/qetscriptapi.h
+++ b/sources/scripting/qetscriptapi.h
@@ -22,6 +22,7 @@
 #include <QString>
 #include <QStringList>
 #include <QVariantList>
+#include <QVariantMap>
 
 class QETProject;
 class DiagramView;
@@ -210,6 +211,13 @@ class DynamicElementTextItem;
 	  the folio properties panel offers; the title block's header sizes,
 	  which it does not, are left alone. Changing the project title is not
 	  undoable: the application sets it directly too.
+	- @b Geometry and folio order: elementGeometry() reads where an element
+	  is -- x, y (its origin), rotation, and the box it occupies on the folio
+	  (left, top, right, bottom) -- so a script can lay one thing out relative
+	  to another instead of only setting absolute coordinates, and can check
+	  that a move landed. insertFolio() puts a new folio at a position
+	  instead of at the end, which is what reordering is mostly for while
+	  moving an existing folio still needs the application's project view.
 	- @b Images: place a picture from a file. The pixels are copied into
 	  the project, which stores them inline in the .qet -- the saved file
 	  does not refer to the original path, so it opens on another machine,
@@ -410,8 +418,12 @@ class QetScriptApi : public QObject
 		Q_INVOKABLE QString folioBorder(int folioIndex, const QString &property) const;
 		Q_INVOKABLE bool setFolioBorder(int folioIndex, const QString &property, const QString &value);
 
+		// -- read an element's geometry --
+		Q_INVOKABLE QVariantMap elementGeometry(int folioIndex, const QString &elementUuid) const;
+
 		// -- folios --
 		Q_INVOKABLE int addFolio();
+		Q_INVOKABLE int insertFolio(int position);
 		Q_INVOKABLE bool setFolioTitle(int folioIndex, const QString &title);
 
 		Q_INVOKABLE bool undo();