worked around user json inconsistency for now, add more docs